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PREFACE 


This manual contains information on the Perkin-Elmer 
Multi-Terminal Monitor (MTM). It is written for the MTM user but 
could be helpful to the System operator and system programmer. 


Chapter 1, which is reorganized, is a general description of the 

MIM system containing general information on MTM systen 
requirements, MTM features, and various conventions. Chapter 2 
describes MIM user commands, and Chapter 3 contains program | 
development commands. Chapter 4 describes batch processing under | 
MTM. Chapter 5 describes the command substitution system (CSS) 

and includes ali CSS commands. Chapter 6 describes spooling. 


Appendix A summarizes the MIM user commands. Appendix B | 
summarizes the program development commands. Appendix C | 
Summarizes the CSS commands and Appendix D summarizes’ the 
terminal user command messages. Appendix E is a summary of CSS 
messages, and Appendix F is a summary of program development { 
command messages. | 


This manual replaces S$29-£91. Revision ROO adds a chapter 
describing the new program development commands. The signon CSS, 
USERINIT.CSS, is made more flexible. Vertical forms control is 
added, and various changes are made to several MTM user commands. 
A Help facility enables a user to access information on how to 
use MTM and program development commands. For batch processing, 
the SUBMIT command is upgraded, and the batch signon requirements 
are simplified. Global and local variables are added to CSS, 
requiring four new commands: SFREE, $GLOBAL, SLOCAL, and SSET. 
Alsc, there is a reserved global variable for end of task codes, 
and there are reserved variables for assigning logical units in 
a program development environment. The SWAIT command is also 
added to CSS. Logical units can now be automatically assigned. 
This revision applies to the OS/32 R06.0 software release and 
higher. 
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The following publications can be used in conjunction with this 
Banuals 


48-043 ROO 5/81 vii 


sean ae Tae) Set ahem ee SOR See Sele ibe eee ia eed nee in nis tid 


PUBLICATION 


MANUAL TITLE NUMBER 
CS/32 AIDS User's Guide $29-374 
OS/32 COPY User Guide $29-676 
32-Bit Systems Software User Documentation 
Summary 48-015 
OS/32 Multi-Terminal Monitor (MTM) 
System Planning and Operator Reference Manual 48-023 
OS/32 Operator Reference Manual 48-030 


OS/32 System Support Utilities 
Reference Manual 48-031 


OS/32 Supervisor Call (SVC) 
Reference Manual 48-038 


OS/32 Application Level Programmer 
Reference Manual 48-039 


For further information on the contents of all Perkin-Elmer 
32-bit software manuals, see the 32-Bit Systems Software User 
Documentation Summary. 
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CHAPTER 1 
GENERAL DESCRIPTION 


1-1 INTRODUCTION 


Multi-terminal monitor (MIM) permits several terminal users to 
share system resources. Fach user perceives that a computer is 
at his disposal. 


Concurrent access from online terminals is useful during 
application task development because it reduces turnaround time. 
Other advantages are that ccncurrent access can be used. to extend 
the type of data processing at an installation. Using the 
system-supplied interactive software means that editing, task 
development, and documentation can be done simultaneously. 
Furthermore, if the system-supplied interactive tasks are 
supplemented by user tasks (u-tasks)3; @ege, customer-written 
tasks, the application of MIM becomes limitless, supporting a 
mixture of terminal users such as clerks, software development, 
and cperation personnel. 


1-2 MTM OPERATION 

Like all general purpose, multi-access, time sharing systems, MIM 
requires operations involvement from the installation using it. 
Thie involvement includes those functions that accompany MIM when 
it ais tailored to a specific installation along with the 


functions performed when MIM is operating; L-Ge, dynamic 
functicns. 


Examples of the MTM tailoring functions are: 


e Cataloging authorized users 
e System generation (sysgen) 


e Fstablishing an installation's procedures 
Examples of dynamic functions are: 


e System console control 
e Peripheral device supervision 


ee Spooled output dissemination 
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Generally, tailoring functicns would be performed and maintained 
by the customer's system support group responsible for making 
computing facilities available to system users. The dynamic 
functions would be perfcrmed by a system operator during system 
operation. The functions performed by a system operator are 
distinct from those functions performed by terminal users. 


The system operator can perform all the functions described in 
the OS/32 Cperator Reference Manual, together with operator 
functions required to administer MTM. At any time, the system 
operator may be initiating and controlling multiple foreground 
tasks and one background task as well as operating MTM. 


1.3 USER INFORMATION 


Under MTM control, a terminal user can: 


® load and execute interactive tasks, 

@e submit multiple batch job requests, 

@e perform program develorment, 

@e perform program debugging, 

@e create, edit, and manirulate files, 

e build, modify, and execute command streams, 
@ use spooling functions, 

@ communicate with other terminal users, and 


@® communicate with the system operator. 


A terminal user is either interacting with MIM itself, via 
commands, or interacting with tasks supplied with the system or 
developed by the installation. All of the vendor-supplied 
language translators can be operated as interactive tasks by a 
terminal user. Additionally, a terminal user can use the 
vendor-supplied support software programs, such as: 0OS/32 Edit, 
0OS/32 Copy, and OS/32 AIDSe It is the MTM software that performs 
multiple online accessibility; e.g-, time sharing, resource 
Management, batch scheduling, etc. 


The terminal user can be situated either locally or remotely. 
The interactive terminals for local users are directly connected 
to the computer without requiring telecommunication devices. 
Interactive terminals for remote users require connection via 
telecommunication equipment and data communications software. 
Basic data communicatidns supports both dedicated and dial up 
telecommunication terminals. 
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1.301 MTM Devices 


These devices can be used at any local or remote installation: 


@ Video Display Unit (VDU) 550 

e@ VLU 1100 

e VDU 1200 

e VDU 1250 

@ Ferkin-Elmer SIGMA 10 terminal 
@e 33 Teletype 

@e M35 Teletype 

e Non-editing VDU 

e Carousel 


@e Carousel 300 and 300 EFC 


1-3-2 Authorization 


The user must be authorized to use MIM facilities. During the 
Signon procedure, the user must supply an account number and a 
password that were previously cataloged within an MTM file called 
the authorized user file (AUF). The AUF is updated and 
Maintained by an MTM-Suprlied task that can be initiated only by 
the system operator. The terminal user can then interact with 
MTM from a terminal. 


1-3-3 Transmitting Messages 
MTM can transmit messages between terminal users, between a 


terminal user and the system operator, and from the systen 
operator to all or designated terminal users. 


1-3-4 Number of Terminal Users 


An installation can have up to 64 terminal users or 64 concurrent 
batch streamse The sum of terminal users and batch streams 
cannot exceed 64. 
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7-4 MIM ENVIRONMENTS 


The MTM terminal user contrcls a single task at the terminal and 
has the ability to run jobs through the batch streams. Using the 
facilities provided by MTM, the user can load a task, start the 
task, and then interact with the task during its execution. MTM 
provides interactive and batch user environments. 


In an interactive environment, the user has the ability to 


interact with a task executing at the terminal. In an 
interactive environment, a dialogue is carried on between the 
user and MTM. MTM waits for the user commands and processes 
them. 


Only one interactive task at a time can be initiated by each MTM 
terminal. However, all interactive tasks initiated by MTM 
terminal users are executed concurrently. During interactive 
task execution, a terminal user can direct a command to and 
receive a response from MIM itself. 


In a batch environment, a number of jobs are run under a full set 
of automated procedures. 


Once a batch job is accepted for execution, no further 
interaction takes place with the initiating terminal user. 
Requests for multiple batch jobs can be submitted by a user, and 
the same terminal can be used to initiate an interactive task. 


Unlike interactive tasks, requests for batch jobs will not 
necessarily be initiated immediately to MTM. Instead, batch jobs 
are queued by the system, and then the queue of submitted batch 
jobs awaiting execution is serviced by the system. The number of 
batch jobs that can be exectting concurrently is specified by the 
system operator. 


A terminal user can request one or more batch jobs to be run. 
MTM maintains a queue of submitted batch jobs and concurrently 
Processes a number of batch jobs specified during MIM system 
start-up. A terminal user can monitor the progress of a batch 
job by interrogating the MTM batch queue. The returned status 
will be either: . 


e awaiting execution, or 


e executing. 


If a job already has completed execution, the returned status 
will be: no jobs found. 
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41-4.1 NTH Terminal Modes 


An active terminal is defined to be in one of four terminal 
modes. The current mode of the terminal determines which, if 
any, MTM terminal commands can be accepted. Thus, it is 
important for the terminal user to be aware of the current mode 
of the terminal. The user terminal is defined to be in one of 
the following four modes: 


e Command Mode; No task is currently loaded, CSS procedure is 
not currently executing and BUILD is not in effect. All 
nontask-related commands are accepted. An "*" prompt is used 
in this mode. 


e Task Loaded Mode: The task was loaded but was not started, or 
is paused. An "*™" prompt is used in this mode. 


e Task Executing Mode: A task was started and is executing. If 
started from CSS, CSS mode is suspendeds- A “-" prompt is used 
in this mode. If an interactive task was started and a data 
input is requested by the task, then a ">" prompt is displayed 
to the terminal user. 


e CSS Mode: A CSS procedure is currently being built or 
executed. A "-" promrt is used in this mode. When CSS 
terminates, the terminal returns to command mode and a "“"***" 
prompt is output. When a CSS procedure is currently being 
built, a “B>" prompt is displayed. 


4-5 LOADING A TASK 


The dynamic nature of OS/32 memory management guarantees loading 
of a task irrespective of its size unless the task is greater 
than the available task memcrye If not enough memory is free to 
load a task, then some other task is temporarily rolled out if 
roll support is included in the operating system at sysgen time. 
If MTM is sysgened with roll influence enabled, then MTM 
continually menitors the state of the roll queue to ensure that 
rolled out tasks are given the opportunity to be rolled back in. 
MTM ensures equity for all its terminal operators by assigning 
all the interactive tasks an equal priority. Batch tasks can 
have user-assigned priorities. 


1-6 MTM SPECIAL FEATURES 
The following features are designed to make MTM easier and amore 


efficient to use: 


e Command substitution system (CSS) 


e Help facility 
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cd 


@ Program development commands 
@e Spooling 
@e Security and access protection of discs 


e Signon CSS 


1.6.1 Command Substitution System (CSS) 


A terminal user can build a command stream on a disc file. Once 
built, a simple directive to MIM will cause MTM to obtain its 
directives from the command file. When invoking the command 


file, the terminal user can supply parameters to the command file 
that can be used to dynamically modify command execution. 
Therefore, a single terminal input can easily initiate complex 
operations. 


1.6.2 The Help Facility 


The Help facility provides a user online access to documentation 
for MIM and program development commands. This information is 
obtained by entering the HELP command. 


1-6-3 Program Development Commands © 


The program development commands are an integrated set of 
standard CSS procedures. They perform two major functions: 


e maintain information that remains constant throughout a 
development effort; and 


e keep files current throughout a development effort in terms of 
checking source, object, and image modules to ensure their 
currentness. 


1.6.4 Spooling 


Both input and output spooling are provided for terminal users. 
Tasks never need to be delayed awaiting card readers, card 
punching, or line printing. The Spooler can be used to submit a 
batch job stream to MIM. The job then runs unattended and output 
is directed toward the Spooler. 


1-6-5 Security and Access Protection of Discs 


Privately owned discs can be parked on restricted by the system 
operator to offer an STH user complete security and access 
protection of files. The owner of the disc can restrict or 
enable access of the disc to other MIM users, the systen 
operator, and non-MTM tasks. 
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91-6.-6 Signon CSS 

MTM users can build a special CSS file, USERINIT.CSS, within 
their private accounts. The CSS can contain commands to load and 
start a terminal session, assign logical units, and specify a 
language environment. At signon time, MTM searches all online 
discs within the user's private account for the file USERINIT.CSS 
and automatically executes it. 

12-7 CONVENTIONS 


These conventions used by MIM are detailed in the following 
sections: 


@ Prompt conventions 

e Terminal conventions 

e Command conventions 

e Statement syntax conventions 

@ File conventions 

1.7.1 Prompt Conventions 

A prompt is output to a terminal device to indicate that the MTM 


system is ready to accept input from the user. The prompts used 
on the terminal devices are shown in Table 1-1. 


TABLE 1-1 PROMPT CONVENTIONS 


ee ee ce re ee ee ee ee ee ee ee es eee ee es ee es ee Oe oe De we oe om OP ee 8 oe oe oe oe oe oe 
SS Se ee cee ae ee ee ee ee ee eee ee ee a oe ORD eS ee ee ee ee we em Oe ae ee Om oe oe oe om om ow 


Indicates MTM system is ready to 
accept another command. 


> Indicates a request for input 
data. 

B> Requests that input data be 
copied to a BUILD file. 


ready to accept a command while 
an interactive task is active. A 
new CSS cannot be initiated at 
this time. A user interactively 
can instruct MIM to suppress or 
enable the appearance of this 
prompt while an interactive task 
is running; but not while CSS is 
running. 


| 
{ 
! 
| 
| 
| 
| 
| 
i 
- | Indicates that the system is 
| 
| 
| 
{ 
| 
{ 
| 
| 
| 
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1-7-2 Terminal Conventions 


The conventions in effect fcr vartous terminal devices are shown 
in Table 1-2. 


TABLE 1-2 TERMINAL CONVENTIONS 


oe ee oe Ger ee oe em em we em om am ey ae WO ee ee ee ee ee ee oe Oh om Gt em Om = ay a SS am Ob oe Gm 2 ee ae oe OD ee Oe On ow ae oe oe oe ee OF) wD Om ee we ee oe om ow ar om oe 
te EF OF SE OF OE EE SE OP ED OD EF SE OS EE OS OS Oe OE OF Oe OS OF SE OF OF SE ON OD OS Se Se OD 


Delete a line To delete a line simultaneously de- 
press the CTRL and character x keys 
for all terminals except TEC 455 CRT 
which uses the number sign (#). Basic 
communications support both # and 
CTRL X for line deletion for asychro- 
nous remote devices. 


| 
| 
| 
I 
l 
| 
| 
| 
Delete a character | To delete a character, depress’ the 
| Backspace key. For terminals without a 
{| Backspace key, simultaneously depress 
| 
| 
I 
{ 
{ 
{ 
| 
{ 
| 


the CTRL and character h keys. 


To process an input line, depress’ the 
carriage return (CR) key. 


End an input line 


To communicate with MTM while an 
interactive task is executing or when 
a BUILD command is active, depress the 
Break key. 


Communicate with MTM 


1-72-2-1 Using the Break Key 


If the data request prompt (>) or a BUILD request prompt (B>) 
appears and the user wishes to communicate with MTM, the Break 
key is depressed and the system is ready to accept a command. 


If an input or output to the terminal is in progress, the Break 
key interrupts the process. For example, if the DISPLAY or 
EXAMINE command was entered and the output is in progress, 
depressing the Break key halts the output in progress. The 
system is then ready to accept a command. 


If CSS is currently running, the Break key interrupts the 
execution of CSS. The system is then ready to accept a command. 
Once the command has executed, €SS will resuase operation unless 
the command entered affetts the status of CSS. 
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167-3 Command Conventions 


Commands are accepted one line at a time. Multiple commands can 
appear on the same line, but each must be separated by a 
semicolon. Multiple commands are executed sequentially. If an 
error is encountered when entering multiple commands on the Same 
line and the command line was entered from a terminal, the 
commands following the command in error are ignored by MTM. For 
a command line entered from a CSS, the commands on the command 
line are skipped until a STERMJOB is found. A line of data 
preceded by a command beginning with an asterisk is considered to 
be a comment. 


1-7-3-1 Statement Syntax Conventions 
Following is a list of syntax conventions used in this manual. 
An example of each syntax convention follows the description. 


Capital letters must be entered exactly as shown. 


SIGNOFF 


Lowercase letters represent parameters or denote information 
provided by the user. 


Underlining points out the mnemonic of the entry and means’7 the 
underlined portion must be entered. 


FAUSE 


An ellipsis represents an indefinite number of parameters or a 
range of parameters. 


fd 
BICHON aserid [-actno,vassvord)|,EAYIRONMENT=) 
| (NULL [2] 
(- CPUTIME=maxtime] 


[-classid=iocount, [,«e+,classid=iocount 32]] 
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Shading represents a default option. 


DISPLAY DEVICES 5 


Braces represent required parameters from which one must _ be 
chosen. 


userid 


MESSAGE message 


2OPERATOR 


Brackets represent an optional parameter. 


NOCCPY) n 
pac | eA | LY ® 
COPY. AS. 


Commas separate parameters and substitute missing positional 
parameters. 


fd 
SIGNON userid [-actno, passvord]|, ENN TRONMENT=| 
NULL [3] 


(- CPUTIME=maxtime] 


[(;classid=iocount, [,...,classid=iocount 32]] 


Braces inside brackets rerresent optional parameters from which 
one can be chosen. 


DISPLAY [EVICES 4 


Commas preceding braces inside brackets must be entered if one of 
the optional rfarameters is chosen. 


DISPLAY DEVICES 4 | 
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A comma inside brackets must be entered if the optional parameter 
is chosen. 


fd 
SIGNON userid [,actno,password] -ERLTRONNENT=} 
NULL [s] 


[- CPUTIME=maxtime] 


[;classid=iocount, [,...,classid=iocount 32]] 
An equal sign associates a parameter with its keyword. 
PUNCH fd |, DEVICE=pseudo device] [, COPIES=n] [DELETE] [,vFc] 


1-7-4 File Conventions 


A file is a collection of data stored on a direct access storage 
device. MTM provides terminal users with the capability of 
creating and editing files in an interactive manner. Once 
created, files remain on the system until they are deleted by the 
owner. However, during the life of a file, ownership can change, 
based on the needs of an installation or project. File ownership 
is established and maintained by MIM via an account number 
mechanism. 


12-7-4.1 Private Account Nusbers 


During the signon procedure a terminal user must supply the 
private account number in addition to the correct password. 
Whenever a terminal user allocates a file during an MTM session, 
the MIM system automatically associates the file with the 
terminal user‘s account number. A file associated with the 
terminal user's account number is referred to as a private file. 


The owner of private files has unrestricted access to those files 
and can update, execute, access, or delete as required. 
Furthermore, no other terminal user can gain access to another 
user's private files. However, to supply greater flexibility for 
file sharing, MTM supports the concept of group files. 


1-7-4.2 Group Account Nusbers 


Authorized MTM terminal users are assigned both a private account 
number and a group account number within the AUF. Unlike the 
private account number, a terminal user is not required to submit 
the group account number during the signon procedure. In fact, 
a terminal user does not need to know the value of the group 
acccunt number. The greur account number will generally be the 
private account number of a different authorized terminal user. 
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By using the RENAME command and supplying the letter ‘G* in the 
account field, a terminal user can change a private file to a 
group file. 


As an illustration of the use of group files within an 
installation, consider a normal development activity consisting 
of two or more members working under a project leader's control. 
During the early development phase, each member would probably 
work alone, using private files. However, during the project 
integration phase, the majority of the private files would be 
switched to the project leader's private account number which was 
defined as the group account for the individual members. 


Once a private file has been switched to a group file, the 
Original private owner nce longer possesses unrestricted file 
Manipulation capability. Instead, the file can be read or 
executed by the original owner and any other terminal user with 
the same grour number. Urdating or deleting the file can now be 
performed by any terminal user who signs on with the group 
account number. 


Although the use of group files provides a somewhat flexible file 
sharing capability, it does not address the problem of universal 
‘sharing. For this purpose, MTM supports the concept of systen 
files. 


1-7-4 3 System Account Numbers 


In a way Similar to switching a private file to a group file, a 
terminal user can supply the letter ‘°S* in the file account field 
instead of the letter ‘G‘. The letter S indicates that this 
private file is now considered a system file. System files have 
an account number of 0. . They can be read or loaded by any 
authorized MTM terminal user. However, updating or deleting a 
system file can be performed only by the system operator. 


Within an MIM environment, the system operator is viewed as more 
privileged than terminal users with respect to file ownership. 
The system operator can allocate system files and can also 
designate an existing file to be made private, group, or system. 
Similar to a terminal user, the system operator uses the RENAME 
command to change file ownershipe | 

1-7-4.-4 File Descriptors 


File descriptors are required with some commands. A file 
descriptor for MTM generally includes four fields: 


e Disc volume name or device name 
@e Filename 
e File extension 


e Account number 
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The format of the file descriptor is: 


P 
voln:filename.ext /\¢\ 


Parameters: 


voln: 


filename 


eext 
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is the name of the disc volume on which the 
file resides, or the name of a device. Voln 
can be from one to four characters. The first 
character nust be alphabetic and the 
remaining, alphanumeric. Voln need not be 
specified. Jf voln is not specified, the 
default volume (set with the VOLUME command) 
is used. When voln is not specified, the 
colon separating voln and filename must not be 
entered. Where voln refers to a device name, 
a colcn must follow the device name and 
neither the filename nor the extension is 
entered. 


is the name of a filee A filename consists of 
from one to eight alphanumeric characters, the 
first cf which must be alphabetic. 


is a 1- to 3-character alphanumeric string 
preceded by a period specifying the extension 
to a filename. If the period (.) and 
extension are omitted, a default extension 
appropriate to the particular command in which 
the fd appears is appended to the filename. 
If the period is specified and the extension 
is omitted, the default is blanks. 


indicates a private filee A private file has 
the same account number as does the terminal 
user who created the file. All of the 
facilities for file manipulation are available 
to the cwner of this file. No other user has 
access tc this file unless it is also a group 
file. That is, the account number of the user 
who created the file is the same as some other 
user's group acccunt number. P is the default 
value if neither P, G, nor S is indicated in 
the command. 


G indicates a group file. A group file, which 
is aeouser’s private file, is accessible to 
other terminal users for read only. The group 
file acccunt number in the AUF indicates to 
the system which users can access this group 


file. 
S indicates a system file. A system file has 
account number O-. A terminal user can only 


read a system file. 
The following are valid exagrles of file descriptors: 


PACK: FRELE.TSK is a private. file FRED.TSK on volume PACK. 


FRED.TSK is the same file as in the previous example, 


if PACK is the default user volume (private 
file). 

ABC:FOO/G is a group file with filename FOO with default 
extension, on volume ABC. 

CARD: is a device name. 

A:B.C/G is a group file B, with extension C on volume 
Ae 
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CHAPTER 2 
MULTI-TERMINAL MONITOR CMTM) USER COMMANDS 


2-1 INTRODUCTION 


The following steps comprise a basic MTM terminal session: 


SIGNON MAR,118,SWDOC Identify yourself to MTM by signing 
on to the system. Enter your 
userid, account number, and a valid 
password. 


VY M300 Establish the volume you will be 
working on by entering the VOLUME 
command and a valid volume name. 


LOAD EDIT32 Load the editor task into memory by 


entering LOAD and the task name. 

START Initiate execution of the task 

« by entering the START command. 

SA FILE1 Save all data appended to your file 
by entering the SAVE command. 

END Terminate execution of the task by 
entering END. 

SIGNOF End the terminal session by signing 
oft. 
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2-2 ALLOCATE COMMAND 


The 


ALLOCATE 


communications 
manager. 


Format: 


ALLOCATE £4, 


Parameters: 


fd 
CONTIGUOUS 


fsize 


INDEX 


lreci 


command creates a direct access file or a 
line control block for a buffered terminal 


is the file descriptor of the device or file 
to be allocated. 


specifies the file type to be allocated is 
contiguous. 


is a decimal number indicating file size which 
is required for contiguous files. It 
specifies the total allocation size in 
256~-byte sectors. This size may be any value 
up to the number of contiguous free sectors 
existing on the specified volume at the time 
the cogmand is entered. 


specifies the file type to be allocated is 


indexed. 


is a decimal number specifying the logical 
record length of an indexed file or ITAM 
device. It cannot exceed 65,535 bytes. Its 
default is 126 bytes. It may optionally be 
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followed by a slash (/) which delimits tlrecil 
from bsize. 


bsize is a decimal number specifying the number of 
256-byte sectors contained in a physical block 
to be used for buffering. This parameter 
cannot exceed the maximum block size 
established at sysgen time. If pbsize is 
omitted, the default value is one sector. 


isize is a decimal number specifying the indexed 
block sizee If isize is omitted, the default 
value is one sector. Like bsize, isize cannot 
exceed the maximum block size established at 
sysgen time. 


ITAM specifies the device to be allocated is a 
communications device. 


keys specifies the write and read protection keys 
for the file. These keys are in the form of 
a hexadecimal halfword, the left byte of which 
signifies the write key and the right byte, 
the read key. If this parameter is omitted, 
both keys default to 0. 


Functional Details: 


To assign an indexed file, sufficient room must exist in systen 
Space for two buffers, each of the stated size. Therefore, if 
bsize or isize is very large, the file might not be assignable in 
some situations. At sysgen time, a maximum block size parameter 
is established in the system and bsize cannot exceed this 
constant. 


The ALLOCATE command can be entered in command mode, task loaded 
mode, and task executing mode. 


Examples: 


AL JANE.TSK,CC,64 Allocates, on the default user 
volume, a contiguous file named 
JANE.TSK whose total length is 64 
sectors (16kb) with protection keys 
of O« 


AL M300:AJM-BLK,IN,132/4 Allocates, on volume M300, an 
. f{ndexed file named AJM.BLK with 

logical record length of 132 bytes, 

data block size of four sectors, and 

default isize of one sector. The 

protection keys default to 0. When 
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AL THISFILE,IN,256/4/2 


AL VOL1:AJM.OBJ,IN,126 


AL VOT: AJM.OBJ,IN,126//3 


this Gile Lo Aro pul kk. ele oy eww 
must have 2.25kb of available system 
Space for buffers. 


Allocates, oon the default user 
volume, an indexed file named 


THISFILE (blank extension) with a 


logical record length of 256 bytes, 
a data block size of four sectors, 
ah index block size of two sectors, 
and protection keys of 0. 


Allocates, oon volume VOL1, an 
indexed file named AJM.-OBJ whose 
logical record length is 126 bytes. 
The buffer size and indexed block 
size default to one sector and the 
Protection keys default to 0. 


Allocates, on volume VO1, an indexed 
file named AJM.OBJ with logical 
record length of 126 bytes. The 
data block size defaults to one 
sector, the index block size is 
three sectors, and the protection 
keys default to 0. 


Messages: 

ALLC-ERR Allocaticn failed for reasons denoted by TYPE 
field. 

FD-ERR Invalid file descriptor 

FORM-ERR Command syntax error 

MNEM-ERR | Incorrect command name 

NOPR-ERR Required operand missing 

PARM~ERR Invalid rfarameter 
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2-3 ASSIGN COMMAND 


 etieetiicn Theta tie tt a 


The ASSIGN command assigns a device, file, or communications 
device to one of a task‘s lcgical units. 


Format: 


ASSIGN lu,fd 


id 


access rfrivileges 


NOTE 


Lt the access privileges and keys 
parameters are omitted and VFC is 
specified, the respective positional 
commas belonging to the omitted 
Farameters also can be omitted if 
desired. 

If the access privileges and VFC 


parameters are specified and the keys 
parameter is omitted, the positional 
comma belonging to the keys parameter can 
be omitted if desired. 


Parameters: 


lu 


fd 


access 
privileges 
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is a decimal number specifying the logical 
unit numbter to which a device or file is to be 
assigned. 


is the file descriptor of the device or file 
to be assigned. 


is the desired access privileges. The default 
access privileges are: 


- SRW for contiguous files and devices 
- SREW fer indexed files 


~ SRO fer files within the groyp or _ system 
account 


keys Signifies the read/write protection keys of 
the file or device to be assigned. 


SVC15 signifies that the specified device is to be 

SVCF assigned for SVC 15 access. SVCF is the 
hexadecimal equivalent of SVC15 and can also 
be specified. This option pertains to 
communications devices only. If SVC 15 access 
is specified, vertical forms control cannot be 
specified. 


VFC specifies the use of vertical forms control 
for the assigned lu. If this parameter is 
specified, SVC 15 access cannot be specified. 
If this parameter is omitted, there is no 
vertical forms control for the device assigned 
to the specified lu. 


Functional Details: 


Access privileges can be one of the following: 


SRC sharable read-only 

ERO exclusive read-cnly 

SWO sharable write-only 

EWO exclusive write-only 

SRW sharable read/write 

SREW sharable read, exclusive write 
ERSW exclusive read, sharable write 
ERW exclusive read/write 


The CLISPLAY LU command is uged to determine the current access 
privileges of all assigned units. The command is rejected if the 
requested access privilege cannot be granted. 


When a task has assigned a file, it might want to prevent other 
tasks from accessing that file while it is being used. For this 
reason, the user can ask for exclusive access privileges, either 
for read or for write, at assignment time. This form of 
protection is called dynamic because it is only in effect while 
the file remains assigned. 


A file cannot be assigned with a requested access privilege if it 
is incompatible with some other existing assignment to that file. 
For example, a request to oren a file for exclusive write-only is 
compatible with an existing assignment for SRO or ERO, but is 
incompatible with any existing assignment for other access 
privileges. Table 2-1 illustrates compatibilities and 
incompatibilities between access privileges. 
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TABLE 2-1 ACCESS PRIVILEGE COMPATIBILITY 


| SRC | SRW | SWO | EWO | SREW | ERW | 


rei 
p= 
" 
x= 
tr] 
oo 
oe] 


* compatible 
- incompatible 


The keys format is a 4-digit hexadecimal number. The left two 
digits signify the write rretection key and the right two digits, 
the read protection key. If omitted, the default is 0000. These 
keys are checked against the appropriate existing keys for the 
file or device. The command is rejected if the keys are invalid. 
The keys associated with a file are specified at file allocation 
time. They may be changed by a REPROTECT command or through an 
SVC 7 reprotect function call. 


If the values of the keys are within the range X'*'01° to X°FE', 
the file or device cannot be assigned for read or write access 
unless the requesting task supplies the matching keys. If a_ key 
has a value of X°00°', the file or device is unfrotected for that 
access modee Any key suprlied is accepted as valid. If a key 
has a value of X°FF*, the file is unconditionally protected for 
that access mode. It cannot be assigned for that access mode to 
any user task, regardless of the key supplied. 
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Some examples of protecticn using keys are: 


WRITE READ 


KEY KEY MEANING 

00 00 Completely unprotected 

FF FF Unconditionally protected 

07 0G Unprotected for read, conditionally 


protected for write (user must 
surply write key=X‘'07‘) 


FF A7 Unconditionally protected for write, 
conditicnally protected for read 


00 FF Unrrotected for write, uncon- 
ditionally protected for read 


27 32 Conditionally protected for both 
read and write 


An assigned direct access file is positioned at the end of the 
file for access privileges SWO and EWO. It is positioned at the 
beginning of the file for all other access privileges. The 
command is rejected if the specified lu is already assigned. To 
reassign an lu for an active task, the lu must first be closed. 


The ASSIGN command may be entered in task loaded mode. 


Examples: 


AS 2,FILE.DAT,EWO,99AA Assigns a disc file to lu 2. The 
EWO access privilege causes the file 
to be positioned at the end. It is 
conditionally protected with write 
and read keys of 99AA. New records 
are appended. 


AS 2,TEST.JOB,VFC Assigns a disc file toa lu Ze 
Vertical forms control is in use. 
Access privileges and keys 


Parameters are omitted along with 
their respective commas. 


AS 2,TEST.JOB,,,VFC Assigns a disc file to lu 26 
Vertical forms control is in uSe. 
Access privileges and keys 
parareters are omitted but 
positional commas are specified. 
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AS 2,TEST.JOB, ,OOFF,VFC 


AS 2,TEST.JOB,SRO,VFC 


Invalid Exaaples: 


AS 2,TEST.JOB,OOFE, VFC 


Assigns a  disce file to lu 26 
Vertical forms control is in use. 
The positional comma belonging to 
the omitted access privileges 
parameter must be specified. 


Assigns a disc file to lu 2% 
Vertical forms control is in uSe. 
The keys parameter, along with the 
positional comma, is omitted. 


Invalid assignment because the 
positional comma belonging to the 
omitted access privileges parameter 
must be specified. 


AS 2,TEST.JOB,SRO,VFC,SVC15 


Nessages: 
ASGN-ERR 


FD-ERR 

FORM-ERR 
MNEM-ERR 
PARM-ERR 
PRIV-ERR 


TASK-ERR 
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Invalid assignment because vertical 
forms control and SVC 15 access are 
mutually exclusive and cannot be 
specified in the same assignment. 


The assign failed for reason denoted by the 
TYPE field. 


Invalid file descrirtor 


Command 


syntax error 


Incorrect command name 


Operand 


syntax error 


Invalid access privilege mnemonic 


No task loaded 


2-4 BFILE COMMAND 


The BFILE command backspaces to the preceding filemark on 
magnetic tapes, cassettes, and direct access files. 


Format: 
BFILE [fd,]1u 
Parameters: 
fd is the file descriptor of the device or file 


to be backspaced to a filemark. 


lu is the lu to which the file is assigned. If 
lu is specified without fd, the operation is 
performed on the lu regardless of what is 
assigned to it. 


Functional Details: 


The BFILE command may be entered in task loaded mode. 


Examples: 
RF 1 Causes the device or file assigned 
to lu 1 to backspace one filemark. 
BEF M300:AJM.OBJ,4 Causes file AJM.OBJ, that is 


assigned to lu 4 on volume M300, to 
backspace one filemark. 


Messages: 


ASGN-ERR The file or device could not be assigned for 
the reascn noted in the TYPE field. 

FORM-ERR Command syntax error. 

I/0-ERR An I/O error was encountered. 
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LU-ERR 
MNEM-ERR 


TASK-ERR 
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An invalid file descriptor was encountered. 
Incorrect command name 


No task loaded. 


2-5 BIAS COMMAND 


The BIAS command sets a base address for the EXAMINE and MODIFY 
commands. 


Format: 


* 


address 
BIAS 


Parameter: 


address is a hexadecimal bias to be added to the 
addrese given in any subsequent EXAMINE or 
MODIFY ccmmande For a u-task, the address 
must be a valid address that exists for the 
u-task. For an e~task, the address can be any 
valid address in the system. The addresses 
must be aligned ona halfword boundary. If 
address is omitted, it is assumed to be 0. 


* is the starting address of the currently 
loaded taske 
Functional Details: 
A BIAS command overrides all previous BIAS commands. The user 
should enter a BIAS command if the current value is unknown. 
The BIAS command can be entered in task loaded mode and task 
executing mode. 


Example: 


BI 100 Sets bias to 100 
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Messages: 


FORM-ERR 
MNEM-ERR 
PARM-ERR 


TASK-ERR 
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Command syntax erro 
Incorrect command name 
Operand syntax error 


No task loaded 


2-6 BREAK COMMAND 


The BREAK command returns a break status (X°8200') to a task with 
ah outstanding I/O on the MIM terminal. 


Format: 
BREAK 
Functional Details: 
The BREAK command may be entered in task executing mode. 
Meseages: 
MNEM-ERR Incorrect command hame 


SEQ-ERR Break was entered when no user task I/0 was 
pending to the MIM terminal. 


2-14 48-043 ROO 5/81 


2.7 BRECORD COMMAND 


The BRECCRD command backspaces to the preceding record on 
Magnetic tapes, cassettes, and direct access files. 


Format: 
BRECORD [£4,] lu 
Parameters: 
fd is the file descriptor of the device or file 


to be backspaced one record. 


lu is the lu to which the file is assigned. Tf 
lu is srfecified without fd, the operation is 
performed on the lu regardless of what is 
assigned te ite 


Functional Details: 


The BRECORD command may be entered in task loaded mode. 


Examples: 

BR 1 Causes the device or file assigned 
to lu 1 to backspace one record. 

BR M300:AJM-OBJ,4 Causes the file AJM-OBJ, assigned to 
lu 4 on volume M300, to backspace 
one record. 

Messages: 

ASGN-ERR The file or device could not be assigned for 
the reascn noted in the TYPE field. 

FORM-ERR Command syntax error. 

I/O-ERR An I/0 error was encountered. 
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LU-ERR An invalid file descriptor was encountered. 
MNEF-ERR Incorrect command name. 


TASK-ERR | No task loaded. 
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2-8 BUILD AND ENDB COMMANDS 


The BUILD and ENDB commands copy data from the command input 
device to the fd specified in the BUILD command. 


Format: 
fd 
BUILD [/ APPEND] 
lu 
ENCDB 


Parameters: 


fd is the file descriptor of the device or file 
to which data is copied. If fd does not 
contain an extension, .CSS is used as a 
default. If a blank extension is desired, the 
period following the filename must be typed. 
If fd refers to a direct access file, an 
indexed file by that name is allocated with a 
logical record length equal to the command 
buffer length established at sysgen time, a 
blocksize of 1, and keys of 0000. If the 
specified fd already exists, that fd is 
deleted and a new fd is allocated. 


lu is the lu to which the file is assigned. A 
temporary file is allocated and the BUILD data 
is ccpied to it. When the ENDB is 


encountered, the temporary file is assigned to 
the specified lu of the loaded task. This 
form cf the BUILD command is only valid when 
a task is loaded. 


APPEND allows the user to append data to an existing 


fd. If the fd does not exist, it is 
allocated. 
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Functional Details: 


Lines entered from the terminal following BUILD are not treated 
as commands, but as data, and are copied to the specified device 
or file until an ENDE is encountered. The ENDB command must be 
the first command in the ccmmand line, but it need not start in 
column 1. ENDB must be followed by other commands in the command 
line. The BUILD command must be the last command on an input 
line. Further data appearing on that line is treated as comment 
and causes no action to be taken. The BUILD command may be 
entered from the terminal only if CSS is not active. It may be 
entered in command mode, task loaded mode, and task executing 
mode. 


Exagpples 


BUILD ASSN 

AS 1, CR: 

AS 2, OUT.OBJ 
AS 3, PR: 

AS 5, CON: 
SEXIT 

ENDB 


Messages: 


ASGN-ERR Output file or device could not be assigned. 

FD-ERR Invalid file descriptor or no indexed file 
support 

FORN-ERR Command syntax error 

LU~ERR The lu specified was already assigned (only 
valid when lu operand is specified). 

MNEM-ERR Incorrect conwand nane 

PARM-ERR Invalid parameter 

SEQ-ERR CSS file active, when BUILD was entered from 


user’s terminal, or BUILD command entered with 
lu operand and task was not dormant. 


TASK-ERR No task loaded 
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2-9 CANCEL COMMAND 


The CANCEL command terminates a task with an end of task code of 


255. 


Formats 


CANCEL 


Functional Details: 


The normal response to this command is: 


Signon name END OF TASK CODE=255 CPUTIME=utime/ostime 


The CANCEL command may be entered in task loaded mode and task 
executing mode. 


Messages: 


FORM-ERR Command syntax error 
MNEM-ERR Incorrect command name 
TASK-ERR No task loaded 
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2e10 CLOSE COMMAND 


The CLOSE command closes (unassigns) one or more files or devices 
assigned to the currently selected task*s logical units. 


Format: 
lu; {-luz,ece,lun] : 
CLOSE 
ALL 
Parareters: 
lu decimal numbers signifying the logical units 
to be unassigned. 
ALL specifies that all logical units of the task 


are to be closed. 
Functional Details: 


Closing an unassigned lu does not produce an error message. A 
CLOSE command can only be entered if the task is dormant or 
paused. 


The CLOSE command may be entered in task loaded mode. 


Examples: 
CL 1,3,5 Closes logical units 1, 3, and 5 of 
the task. 
CLOSE A Closes all logical units of the 
task. 
Messages: 
CLOS-ERR Close failed for reason denoted by TYPE field 
FORM-ERR Command syntax error 
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MNEM-ERR 
NOPR-ERR 
PARM-ERR 
SEQ-ERR 


TASK-ERR 
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Incorrect command name 
Required argument missing 
Invalid cr missing parameter 
Task net dormant or paused 


No task loaded 


se wewwreewen ew @ 


{ CONTINUE | 


2011 CONTINUE COMMAND 
The CCNTINUE command causes a task that has been paused to resume 
operation. 
Format: 
CONTINUE [address] 


Parameter: 


address is a hexadecimal number that specifies where 
the task is to resume operation. If this 
parameter is not specified or is 0, the task 
resumes at the instruction following the 
pausee 


Functional Details: 


The CONTINUE command may be entered in task loaded mode. 
Executing this command causes the terminal mode to be switched 
from task loaded mode to task executing mode. 


Messages? 

FORM-~ERR Command syntax error 
MNEM-ERR Incorrect command name 
SEQ-ERR Task not paused 
TASK-ERR | No task loaded 
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2012 DELETE COMMAND 


The DELETE command deletes a direct access file. 
Format: 


DELETE fd, [,fd2--++rfda] 


Parameter: 


fd identifies the file(s) to be deleted. 


Functional Details: 


The file being deleted must not be currently assigned to any lu 
of any task. A file can only be deleted if its write and read 
protection keys are 0 (X'0000'). If the keys are nonzero, they 
can be changed using the REPROTECT command. Only private files 
may be deleted. 


The DELETE command may be entered in command mode, task loaded 
mode, and task executing mode. 


Messages: 

DELE-ERR TYPE= Delete failed for reason denoted by TYPE field 

NAME File with the specified name was not found 

PROT Protecticn keys for the specified file are 
other than 0 

PRIV Specified file is assigned to a task 

VOL Nonexistent file is assigned to a task 

TYPE Incorrect device type was specified 

BUFF Insufficient memory available in system space 
to delete an indexed file 

FD-ERR Invalid file descriptor 

FORM-ERR Command syntax error 

MNEM-ERR Incorrect command name 
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2-13 DISPLAY ACCOUNTING COMMAND 
The DISPLAY ACCOUNTING command displays accounting data collected 


for a currently running or rreviously run task. 


Format: 


DISPLAY ACCOUNTING B 
8 


Parameters: 


fd is the file descriptor to which the accounting 
information is displayed. 


Functional Details: 


The DISPLAY ACCOUNTING command displays this information: 


USER TIME hh:mm:ss.ems 
CS TIME hhsmm:ssems 
WAIT TIME hhemme:ssems 
ROLL TIME hhs:mm:ssems 
T/O on 
ROLL n 


The DISPLAY ACCOUNTING command may be entered in command mode, 
(providing at least one task has been run during the current 
terminal session), task loaded mode, and task executing mode. 


Messages: 

ASGN-ERR Output device could not be assigned 
FD-ERR Invalid file descriptor 

FCRM-~ERR Command eyntax error 


I/O-ERR I/0 error encountered on output device/file 
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MNEH-ERR 
PARM-ERR 


SEQ-ERR 
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Incorrect command name 
Invalid rparameter 


No task has yet been run 
terminal session. 


during 


the 


current 


2°14 DISPLAY DEVICES COMBAND 


The DISPLAY LEVICES command displays to the specified fd the 
physical address, keys, online/offline state, and the volume name 
(for online direct access devices) of all devices in the system. 


Format: 
fd 
DISPLAY [EVICES [4 ] 
Parameters: 
fd is the file descriptor specifying the file or 


device to which the display is routed. If fd 
is omitted, the display is output to the 
terminal. 


Functional Details: 


The DISPLAY DEVICES command may be entered in command mode, task 
loaded mode, and task executing mode. 


Example: 


NAME DN KEYS 
NULL 0 0000 

CON (2 0000 

CR —- 4 0000 

PRT 62 0000 

PTRP 13 0000 

PR 0 0000 SPOL 
SPL 0 0000 SPOL 
CRT1 30 0000 

CRT2 14 0000 

MAG1 85 0000 
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CPSc1 Cé 0000 MUD1 PROT CDIR 


DSC2 C7 0000 FIXED RES CDIR 
DSC3 D6 0000 MTM SYS 

DScy D7 0000 FIX 

DSC5 E6 0000 OFF 


T6é7A FC 0000 V67A CDIR 
* 


. In the DISPLAY DEVICES output, columns 1, 2, and 3 contain the 
device name, device number (address), and keys, respectively. 
Column 4 is only defined fcr pseudo-print (spool) and direct 
access devices. The characters SPOL specify that the devices are 
pseudo-print devices used in spooling. 


For direct access devices, column 4 contains the characters OFF 
to indicate that the device is offline. If online, the volume 
name is output in column 4. For write-protected discs, column 5 
contains the characters FROT. For MTM users, if the disc is 
write-protected, column 5 contains the characters SYS. If the 
disc is restricted, column £ contains the characters RES. If the 
seccndary directory option is enabled, the last column contains 
the characters CDIR. 


Messages: 

ASGN-ERR Optional fd could not be assigned 

FD-ERR Invalid file descriptor 

FORM-ERR Command syntax error 

I/O-ERR I/O error encountered on output device or file 
MNEM-ERR Incorrect command name 

PARM-ERR Operand syntax error 


48-043 ROO 5/81 2-27 


we ee ee amen are 


J DISPLAY {f 
| DEFLOAT i 


2-1& DISPLAY DFLOAT COMMAND 


The DISPLAY CFLOAT command displays to the specified fd the 
contents of the double precision floating point registers 
asscciated with the loaded task. 


Format: 


DISPLAY [FLOAT E 


Parameter: 


fd is the file descriptor specifying the file or 
device to which the contents of the double 
precision floating point registers associated 
with a user-specified task are displayed. If 
fd is omitted, the display is output to the 
terminal. 


Functional Details: 


The user-specified task should have been built with the DFLOAT 
option at Link time. 


The DISPLAY LFLOAT command may be entered in task loaded and task 
executing mode. 


Example: 
ro oCFL 
0,2 00000000 00000000 00000000 00000000 
4,6 00000000 00000000 00000000 00000000 
8,A 00000000 000000C0 00000000 00000000 
C,E 00000000 00000000 00000000 00000000 
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Messages: 


ASGN-ERR Optional fd could not be assigned; e.g., fd is | 
already assigned for exclusive use | 
FD-ERR Invalid file descriptor | 
FORM~ERR Command syntax error | 
I/O~-ERR I/O errer encountered on output file or | 
device. | 
MNEM-ERR Incorrect command name 
NOFF-ERR Task not built with the DFLOAT option at Link | 
time | 
PARM-ERR Operand syntax error | 
TASK-ERR No task loaded { 
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{ FILES 


2-16 DISPLAY FILES COMMAND 


The DISPLAY FILES command permits information from the directory 


of one or 
fd. 


Format: 


DISPLAY FILES |, 7 


Paraneters: 


volns: 


filename 


ext 


fd 


more direct access files to be output to a specified 


volns 


} [filename] [. [ext] 


is a 1- to Uecharacter name of a disc volume. 
The first character must be alphabetic, the 
remaining alphanumerice If voln is omitted, 
the default user volume is assumed. 


is a 1~ to 8-character name of a file. The 
first character must be alphabetic, the 
remaining, alphanumeric. 


is a  1- to 3echaracter extension to the 
filename. 


indicates that information is requested for a 
private file. 


indicates that information is requested on a 
system file: default is private files only. 


indicates that information is requested for a 
group file; default is private files only. 


is the file descriptor specifying the file or 
the device to which the display is output. If 
fd is omitted, the display is output to the 
user terminal. 
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Functional Details: 


A hyphen (-) in the command format requests that all files 
Starting with the characters preceding the - are displayed, 
subject to any restrictions specified in the extension, account 
number, and fd fields. Fcr example: | 


CAL32- displays all files whose first five characters 
are CAL3z. 


CAL32.- displays all files named CAL32 with any 
extension. 


The character * requests that all files with matching characters 
in the same position(s) as those entered are displayed. For 
example: ‘ 


CAL32*** displays all files between five and eight 
characters in length whose first five 
characters are CAL32. 


CAL**CAL displays ail files, with a filename eight 
characters long, whose first three and last 
three characters are CAL. 


ween 32 .OBJ displays all files with a filename containing 
six characters whose fifth and sixth 
characters are 32 and whose extension is .OBJ. 


The characters * and - can be combined in the command format, as 
described previously, to further delimit files displayed. For 
example: 


CAL**1- displays all files whose first three 
characters are CAL, and whose sixth character 
is 1° ; 


An example of the display produced by the DISPLAY FILES command 
is: 


VOLUME= FIXD 
FILENAME EXT TYPE LENGTH KEYS START/NLR CREATED WRITTEN ACT 


DSKSPACE TSK Co 9 **00 E* 6/09/79 6/09/79 0 
OSCOPY TSK IN 256 **00 21 6/09/79 6/09/79 0 
JFC TSK CO 81 **00 E3* 4/07/79 4/07/79 0 
COBOL TSK co 26 **00 134* 7/27/78 0/00/00 0 
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D F,TAS-/- 


VCLUME= V67B 
FILENAME EXT TYPE LENGTH KEYS START/NLR CREATED WRITTEN ACT 


TAS css IN 80 **00 1 6/09/79 6/09/79 18 
TASKRT TSK co 105 0000 218A* 4/07/79 &/07/79 22 
L F,-e-/S 


VOLUME= V67B 

FILENAME EXT TYPE LENGTH KEYS START/NLR CREATED WRITTEN ACT 
INA1 IN 126 **00 0 6/09/79 6/09/79 0 
INA2 Css IN 100 **00 1 6/09/79 6/09/79 0 


For contiguous files, TYPE is CO, LENGTH is the number of sectors 
allocated to the file in decimal, and START/NLIR is the starting 
sector number in hexadecimal, followed by *. 


For indexed files, TYPE is IN, length is the logical record 
length in decimal, and the START/NLR is the number of logical 
records in decimal. 


ACT is the associated user's account number. It is the user's 
account number for private files, the group account number for 
group files and 0 for system files. 


The DISPLAY FILES command can be entered in command mode, task 
loaded mode, and task executing mode. 


Examples: 

DF displays to the user terminal all 
files with the user‘s account number 
on the default user volume. 

D F,CAL32-eTSK/- displays file CAL32.TSK in the 
private, group, and system accounts. 

LD F,-/- displays all files in the private 
group and system accounts) on the 
default user volume. 

D F,,MAG1: displays, to the device MAGi, all 

. files with the user's account number 
on the default user volume. 

D F,M300: displays, to the user's terminal, 


all files with the user's account 
number on volume M300. 
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D EF,M300:A-.TSK 


CD F,~e,PR1: 


DUR CALS F T-<= 


D F,M-:TASK.5* 


D F,-~:TASKe- 


Messages: 


ASGN-ERR 
FORM-ERR 


I/O-ERR 


MNEM~ERR 


NOPR-ERR 


PARM-ERR 
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displays all files on volume 4300 
with first character A and extension 
TSK in the user's account number. 


displays all files on the default 
user volume in the user's account 
number with biank extension, 
regardless of filename. The display 
is routed to device PR1. 


displays, to the user's terminal, 
all files that start with CAL, 
contain the character 1 in the sixth 
position, have any extension and are 
in the user's account number. 


displays to the user’s terminal the 
files named TASK that have one or 
two character extensions starting 
with the character 5. A separate 
display of these files is done for 
each online disc volume whose name 
starts with the letter MM. 


displays to the user's terminal the 
files hamed TASK, with any 
extension. A separate display of 


these files is done for each online 
disc volume in the systen. 


Optional fd could not be assigned 
Command syntax error 


I/O error encountered on output 
device or file 


Incorrect command name 


Required operand missing on output 
device or file 


Operand syntax error 


7 Da ae 


| FLOAT | 
2-17 DISPLAY FLOAT COMMAND 
The DISPLAY FLOAT command displays to the specified fd the 


contents of the single precision floating point registers 
associated with a the loaded task. 


Format: 


Parameter: 


fd is an cptional file descrirtor specifying the 
file or device to which the display is output. 
If fd is omitted, the display is output to the 
user's terminal. 


Functional Details: 
The user-specified task must be built with the FLOAT option 


specified at Link time. 


The DISPLAY FLOAT command may be entered in task loaded mode. 


Examples 
D FL 
0,2 00000000 00000000 
4,6 00000000 00000000 
8,A 00000000 00000C0C 
Cr,E 00000000 00000C0C 
Messages: 
ASGN-ERR Optional fd could not be assigned; e.g., fd is 
already assigned for exclusive use 
FD-ERR Invalid file descriptor 
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FORM-ERR 
I/O-ERR 
MNEM~-ERR 


NOFP-ERR 


PARM~-ERR 


TASK-ERR 
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Command syntax error 


I/O error encountered on output file or device 


Incorrect command name 


Specified task not established with the 
option at Link time 


Operand syntax error 


No task loaded 


FLOAT 


i LU i 


2-18 DISPLAY LU COMMAND 
The DISPLAY LU command displays to the specified fd all assigned 
logical units of the loaded task. 


Format: 


DISPLAY IU E 


Parameter: 


fd is an cptional file descriptor specifying the 
file or device to which the assigned logical 
units are to be displayed. If fd is omitted, 
the display is output to the user's terminal. 


Functional Details: 


The lu number, file or device name, current access privileges, 
current record number, and percentage thru file are displayed. 
The current record number and percentage thru file are displayed 
only for files. 


U FILE/DEVICE — RECORD THRU 
1 M67A: RADPROC.CSS/000,SR0 30 15.0% 
= CON:,SRW 

5 CCN:,SRW 

6 CON:,SRW 


M67A: RADPROC.CSS/000,SRO 200 100.0% 
CON:,SRW . 

M67A: &62614586.001/000,/SREW 1 100.0% 
CON:,SRW 

CON:,SRW 


Am & WwW = 


The DISPLAY LU command may Le entered in task loaded mode and 
task executing mode. . 
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Exagple: 


DISP LU,PR: Displays assigned logical units to 
the printer device (PR:). 


Messages: 

ASGN-ERR Optional fd could not be assigned; e.g., fd is 
already assigned for exclusive use 

FD-ERR Invalid optional file descriptor 

FORM-ERR Command syntax error 

I/O-ERR | I/O error detected on output device or file 

MNEM-ERR Incorrect command name 

PARM-ERR Operand syntax error 

TASK-ERR No task loaded 
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{| DISPLAY | 
| PARAMETERS | 


2-19 DISPLAY PARAMETERS COMMAND 
The DISPLAY PARAMETERS command displays the parameters of the 
loaded task. 


Format: 


DISPLAY PARAMETERS E 
BS 


Parameter: 


fd is an cptional file descriptor specifying the 
file or device to which the display is output. 
If fd is omitted, the display appears at the 
user ccnsole. 


Functional Details: 


Table 2-2 lists the field addresses and data displayed when the 
DISPLAY PARAMETERS command is entered. 
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TABLE 2-2 DISPLAY PARAMETERS COMMAND FIELDS 


j FIELD {| VALUE { MEANING | 
[Hees ressssssssssesretsessse SSSeesassesessessezzrss== | 
} TASK | xxxxxxxx | Task name, aiso user signon | 
| | | name | 
{ | | { 
{ CTSW | xxxxxxxx | Statue portion of current TSW | 
i | | | 
{ CLOC | xxxxx | Current location { 
| | | | 
{ STAT | xxxxx | Task wait status | 
[ | [ 
{| TOPT | xxxxx | Task options | 
i I { | 
{ USSP | xxxxx | Current used system space | 
| | { l 
{| MUSP | xxxxx | Maximum used system space { 
| | | { 
| MXSP | xxxxx | Maximum allowed system space _ | 
| | i [ 
| cTCP | xxxxx | Task CTOP | 
| | | | 
| UTOP f xxxxx | Task UTOP | 
| | | [ 
{ UBOT | xxxxx | Task UBOT | 
{ | ; { 
{ SLOC f{ xxx | Task starting location | 
{ | | I 
{ NLU | xx | Number of logical units | 
| | | (decimal) | 
| i I | 
{ MPRI | xxx | Maximum priority (decimal) | 
{ { | { 
{ SVOL | xxxx | Lefault volume id | 


The addresses displayed as CTOP, UTOP, UBOT, and SLOC are not 
physical addresses, but are addresses within the task‘s own 
program space. CLOC may te a program space address or a physical 
address in a system subroutine being executed on behalf of the 
task. NLU is given in decimal. SVOL is the ASCII system volume 
id. The fields cCTOP, UICP, UBCT, and SLOC are described in 
detail in the OS/32 Application Level Programmer Reference 
Manual. 
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TCPT is given in hexadecimal. The definitions of task option 
bits are listed in Table 2-3. 


TABLE 2-3 TASK OPTION BIT DEFINITIONS 


| BIT | MASK { MEANING 


a ee ee ee Se ee ee ee es eS TS ee ee ee 


0400 0000 O ~ Prompt disabled 
1 - Prompt enabled 


1 
| | 
| | | | 
| | | | 
| { | | 
{ 6 {| 0200 0000 {| 0 - I/O interpreted without vertical | 
{ | | ferms control | 
{ { {1 1- A111 I/C interpreted with vertical | 
{ | | forms control | 
{ | { | 
! 7 J} 0100 0000 {| 0 - Ne extended SVC 1 parameter blocks | 
| | | used (excludes communications I/0) | 
| | -{ 1- Extended SVC 1 parameter blocks | 
| | | used | 
| i | | 
{ 8 | 0866 0060 | 0 ~ New TSW for task event service | 
{ | |! 1- No new TSW for task event service | 
{ | 1 | 
{ 9 | 0040 0000 { O ~- Task event all registers saved { 
{ | | 1 Task event partial registers saved | 
| | | | 
i 10 { 0020 0000 | O - Task event no register saved | 
| | {| 1- Task event register saved | 
{ { | [ 
1 16 | 0000 8000 }| 0 - U-task | 
| | | 1 - E-task | 
| ! i | 
{| 17 {| 0000 4000 | O - AFFAUSE { 
| { | 1 - AECONT | 
| | | 
{| 18 | 0000 2000 { 0 - NOFLOAT | | 
| | {| 1 - Single floating point | 
| { | { 
} 19 | 0000 1000 {| O - NCNRESIDENT | 
| | { 1 - RESIDENT | 
{ { | | 
{| 20 [{ 0000 0800 { 0 ~ SVC 6 control call | 
| | | 1 - Prevent SVC 6 control call } 
| | | | 
{ 217 | 0000 0400 | 0 - SVC 6 communication call | 
{ | { 1- Prevent SVC 6 communication call | 
| { | | 
{| 22 {| 0000 0200 | 0 - SVCPAUSE | 
| | { 1 - SVCCONT | 
| | | 
{ 23 {| 0000 0100 {| 0 - NCFLOAT | 
| | 1 | 


1 - DFLOAT 
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TABLE 2-3 TASK OPTION BIT DEFINITIONS (Continued ) 


— a ae a ee om ee em ee ew em aw a ae om ame ee ED a POP ae ae 6m om Ge @ G os OD an am OP am om @® @® oF a® © OP OD @ ww oe we 


BIT | MASK | MEANING 
24 0000 0080 | 0 - NCRCLL | 

4 = RCLL 
25 0000 0040 0 - Ne overlay 


1 - Use overlay 


| | 
{ | 
| | | | 
| | l { 
| | | | 
I I | { 
| | | l 
| | | ! 
} 26 { 0000 0020 | 0 - Accounting disabled | 
I | } 1 - Accounting enabled i 
| | I { 
! 27 |{ 0000 0010 { O - Task can issue intercept call | 
| { {| 1 - Task cannot issue intercept call | 
| | | [ 
{i 28 { 0000 0008 {| 0 = No account privileges | 
| | | 1 - File account privileges | 
l l l 
{ 29 { 000 0004 | O - Bare disc assign not allowed | 
| | {| 1 - Bare disc assign allowed ] 
| { | { 
{| 30 {f 0000 0002 | 0 - Not universal ! 
[ | | 1 - Universal 
| | | | l 
{ 31 [ GO00 0001 { 0 - Ne keychecks J 
| { | | 


1 - De keychecks (e-tasks only) 


name ea ee Oe OP ees SPs Be eee eee we a Cwns wa qe e ewe wee wroeeoewzeaerwroroe2ee= @= 


STAT is given in hexadecimal. The definitions of wait status 
bits are shown in Table 2-4. 


TABLE 2-8 WAIT STATUS BIT DEFINITIONS 


[BIT] MASK |” MEANING 
| 15 | 0001 0000 | Intercept vait. | 
| 16 | 0000 8000 I/O wait | 
17 0000 4000 | (Any) IOB/WAIT 
| 18 0000 2000 Console wait towasead 
19 0000 1000 Lead wait 
20 0000 0800 Dormant ! 
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TABLE 2-4 WAIT STATUS BIT DEFINITIONS (Continued) 


ee EN a A A a ee ee eh od a ek ee ee ee ee ey 


| BIT | MASK { MEANING | 
foi (0b b400 | Geapwaien SS SCSCCCtC ! 
22 0000 0200 Time of day wait | 
23 0000 0100 Suspended | 
| 24 ! 0000 0080 Interval wait ! 
25 0000 0040 ! Terminal wait 
26 0000 0020 Roll pending wait | 
27 0000 0010 | Intercept initialization (MTM) 
28 0000 0068 Intercept termination (MTM) | 
| 29 | 0000 0004 System resource connection wait 
. 30 | 0000 0002 Accounting wait 


NOTE 


zero status indicates the task is active. 


CTSW is given in hexadecimal. For a definition of the status 
portion of the TSW, see the 0S/32 Applications Level Programmer 
Reference Manual. 


The CISPLAY FARAMETERS command can be entered in task loaded mode 
and task executing mode. 


Example: 


The following is an example of the output generated in response 
to a DISPLAY FARAMETERS command; 
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LAS 
CTSwW 
PSW 

CLOC 
STAT 
TOPT 
USSP 
MUSP 
MXSP 
CTOP 
UTOP 
UBCT 
SLOC 
NLU 

MPRI 
SVOL 


Messages: 


ASGN-ERR 
FD-ERR 
FORM-ERR 
I/O-ERR 
MNEM-ERR 
PARM-ERR 


TASK-ERR 
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BLNUDED 
00001000 
477FO 
F2B7C 
2000 
10021 
14F8 
2208 
3000 
24FE 
2370 
0 
FO0O00 
15 
128 
M67A 


Optional fd could not be assigned 
Invalid file descriptor 


Command 


syntax error 


I/O error detected on output device or file 


Incorrect command name 
Operand syntax error 


No task loaded 


5/81 


} DISPLAY jf 
{ REGISTERS | 


2-20 


The DISPLAY REGISTERS command displays to the 


contents 


Format: 


LISPLAY REGISTERS He 
x 


DISPLAY REGISTERS COMMAND 


specified fd the 


of the general purpose user registers associated with a 
loaded task. 


Parameter: 


fd 


Functional Details: 


fd 


is the file descriptor to which the contents 
of the general purpose user registers are 
displayed. I£ fd is omitted, the display is 


output te the user console. 


The DISPLAY REGISTERS command can be entered in task loaded mode 
and task executing mode. 
Example: 
DR 
PSW O000077F0O OOOOES8S8 . 
0-3 00000000 00000000 00000000 00004801 
4-7 OO00E83C 00000000 #£=900000000 OOOOD2EA 
8-B OOOGES8CB 00000000 OOO00E8 4B 00000028 
C-F QOOOOE804 OOOOESDO £OOODODES8BY4 OOOOEOSE 
Messages: 
ASGN-ERR Optional fd could not be assigned; e.g., fd is 
already assigned for exclusive use 
FD-ERR Invalid file descriptor 
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FORM-ERR 
I/O-ERR 

MNEM-~ERR 
PARM-ERR 


TASK-ERR 
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Command eyntax error 


I/O error detected on output device or file 


Incorrect command name 
Operand syntax error: 


No task loaded 


NOTE 


The contents cf each register will be 0 
until the task has started. 


5/81 


| TIME | 


2021 DISPLAY TIME COMMAND 


The DISPLAY TIME command displays the current date and time to a 
specified fd. 


Format: 


Parameter: 


fd specifies the file or device to which the 
display is to be output. If fd is omitted, 
the digplay is output to the user terminal. 


Functional Details: 

The display has the following format: 
mm/dd/yy hhenne:ss 

or alternatively (by sysgen satieass 
dd/mm/yy hhenn:ss 


The DISPLAY TIME command can be entered in command mode, task 
loaded mode, and task executing mode. 


Messages: 

ASGN-ERR Optional fd could not be assigned 
FD-ERR Invalid file descriptor 

FORM-ERR Command syntax error 


2-46 | 48-043 ROO 5/81 


I/O-ERR I/C error encountered on output device or file 
MNEM-ERR Incorrect command name 


PARM-ERR Operand syntax error 
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2e22 DISPLAY USERS COMMAND 


The DISPLAY USERS command displays the userid and terminal device 
names of all users currently signed on. 


Formats 


fd 
DISPLAY USERS |, 
uGer console 


Parameter: 


fd specifies the file or device to which the 
display is output. If fd is omitted, the 
display is output to the user console. 


This command may be entered in command mode, task loaded amode, 
and task executing mode. 


Examples: 


DU 
ME-CTO1: STARTERI-CT023 AVE-CT03: JAW-CTO4: 


Messages: 

ASGN-ERR Output device could not be assigned 

FD-ERR Invalid file descriptor 

FORM-ERR | Command syntax error 

I/O-ERR I/O error encountered on output device or file 
MNEM-ERR Incorrect command name 

PARM-ERR Invalid rfarameter 
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2e23 ENABLE COMMAN 


The ENABLE command 
suppressed by the 
console. 


Format: 
MESSAGE 
PRCMPT 
ENABLE 
EIM 
SVARIAB 


Parameters: 


MESSAGE 


PROMPT 


ETM 


SVARIABLE 


D 


allows the prompt or messages previously 
PREVENT command to be displayed on the user 


LE 


allows other MTM users to send messages to the 
user terminal. 


reguests the system to print the hyphen (-) 
prompt in task executing mode. 


displays the end of task message. 


enables variable processing on a per user 


basis. 


Functional Details: 
The ENABLE command 

Variable support is 
sysgen option SGN.V 


Messages: 


FORM-ERR 
MNEM-ERR 


PARM-ERR 
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does not affect operator messages. 


included in the target system through the 
AR. 


Command syntax error 
Incorrect command name 


Operand syntax error. 


2e24 EXAMINE COMMAND 
The EXAMINE command examines the contents of a memory location in 


the loaded task. 


Format: 


fd 


EXAMINE address, jaeceel| | 


ai } 


Parameters: 
address indicates the starting and ending addresses in 
memory whose contents are to be displayed in 
hexadecimal. All addresses specified are 
rounded down to halfword boundaries by the 
system. 
n is a decimal number specifying the number of 


halfwords to be displayed. If n is omitted, 
one halfword is displayed. 


fd is the file descriptor specifying the file or 
; device to which the contents of memory are 
displayed. If omitted, the display is ‘output 

to the user's console, 


Functional Details: 


Specifying only address, causes the contents of memory at that 
location (as modified Ey any previous BIAS command) to be 
displayed. Specifying address, and address, causes all data from 
the first to the second address to be displayed. 


The EXAMINE command can be entered in task loaded mode and task 
executing mode. 


Any memory that may be accessed by the loaded task may be 
examined with the EXAMINE command. For example, if a task uses 
a PURE segment that is wapped to segment register F, then 
examining addresses at FOO0O00 or greater will display the contents 
of the PURE segment. 
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Example: 


BI BOOO Examines 10 halfwords starting at 
EXA 100,10 relative address 100 (absolute 
address B100) within the task. 


Messages: 

FD-ERR Invalid file descriptor 

FORM-ERR Command syntax error 

I/O-ERR I/O error detected on output device or file 

MNEM-ERR Incorrect command name 

NCPR-ERR Required cperand missing 

PARM~-ERR Operand syntax error (an attempt to examine 
memory reserved for MAC, or marked off and 
possibly nonexistent) 

ROLL-ERR Task currently rolled out 

TASK-ERR No task lcaded 
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2025 FFILE COMMAND 


The FFILE command forward spaces to the next filemark on magnetic 
tapes, cassettes, and direct access files. 


Format: 

FFILE [£4,] lu 
Parameters: 

fd 


lu 


Functional Details: 


is the file descriptor of the device or file, 
to be forward spaced one filemark. 


is the lu to which the file is assigned. If 
lu is srecified without fd, the operation is 
performed on the lu regardless of what is 
assigned to it. 


The FFILE command may be entered in task loaded mode. 


Examples: 

FF 14 Causes the file or device assigned 
to lu 1 to forward space one 
filemark. 

FF M3003:AJM.OBJ,4 Causes the file AJM-~-OBJ on volume 
M300 that is assigned to lu4d, to 
forward space one filemark. 

Messages: 

ASGN-ERR The file or device could not be assigned for 
the reason noted in the TYPE field 

FORM-ERR Command syntax error 
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I/C-~ERR I/C error encountered on the specified device 


or file 

LU-ERR Logical unit not a legal decimal number or 
greater than maximum lu for the task 

MNEM~-ERR Incorrect command name 

TASK-ERR No task loaded 
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2-26 FRECORD COMMA 
The FRECORD command 
cassettes, and dire 
Formats: 

FRECORD [£d,] lu 
Parameters: 


fd 


lu 


Functional Details: 
The FRECORD command 
Examples: 

FR 1 


FR M300: AJMN.OBJ 


Messages: 
ASGN-ERR 


FORM~ERR 


I/C-ERR 


ND 


forward spaces one record on magnetic tapes, 
ct access files. 


is the file descriptor of the device or file 
to be forward spaced one recorde 


is the lu to which the device or file is 
assigned. If lu is specified without fd, the 
operation is performed on the lu regardless of 
what is assigned to it. 


can be entered in task loaded mode. 


Causes the device or file assigned 
to lu 1 to forward space one record. 


74 Causes file M300:AJM-OBJ oon volume 


M300 that is assigned to lu 4&4 to 
forward space one record. 


The file or device could not be assigned for 
the reason noted in the TYPE field. 


Command syntax error 


I/O error encountered on the specified device 
or file. 
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LU-ERR 


MNEM-ERR 


TASK-ERR 
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Logical unit not a legal decimal number or 
greater than the maximum lu specified for the 
taske 


All commands on the same line following an 
erronecus command are ignored. 


There was no task loaded. 


2e27 HELP Command 


The HELP command displays information on how to use MTM and 
program development commands. 


Forpat: 


mnemonic 
HELP 


* 


Parameters: 
mnemonic is any valid MTM mnemonic Or program 
development command. 
* causes a list of all MIM and program 


develorment commands to be displayed to the 
list device. 


Functional Details: 


The HELP command is inplemented as a CSS. procedure. When a 
mnemonic or command is entered, information on how to use that 
Particular command is displayed to the list device. If 


parameters are omitted, information on how to use the HELP 
command is displayed to the list device. 


Exaaples:; 

HELP LOG displays to the list device 
information on how to use the MTM 
LOG command. 

HELP COMPILE displays to the list device 
information on how to use the 
program development command, 
COMPILE. 
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2228 INIT COMMAND 


The INIT (file initialization) command initializes all data on a 
contiguous file to 0. 


Formats: 


segsize increment 
INIT fd |, 7 
4 


Parameters: 
fd is the file descriptor of any unassigned, 
unprotected, contiguous file. 
segsize is the size of the buffer space used. The 
increment default is 1kb. 
Functional Details: 
INIT is implemented with a CSS procedure that loads and starts 
the File Manager Support Utility as a task. 


The INIT command can be entered in command mode. 
Examples: 


INIT DATA.FIL Initializes the file DATA.FIL. 


INIT DATA2.FIL,50 Initializes the file DATA2.FIL using 
a 50kb buffer. 


Messages: 


ASGN-ERR An error occurred when an attempt was made to 
assign the file to be initialized or the task 
file fer the File Manager Support Utility. 
See the ASSIGN command description for error 
information. 
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FD-ERR 


fd IS NOT A 
CONTIGUOUS FILE 


FORM-ERR 


LOAD-ERR 


MNEM-ERR 


SEQ-ERR 


xxxx ERRCR ON fd 
SECTOR n 


Invalid file descriptor was specified 


INIT can only be used to initialize 
contiguous files. 


Invalid segment size increment was specified 


An error occurred when an attempt was made to 
load the File Manager Support Utility. See 
the LOAD command for error information on 
loading a taske 


An incorrect command name was specified. 


Another CSS procedure is active. A second 
INIT command cannot be executed until the 
first has completed. 


An I/O error occurred while attempting to 
initialize sector n of file fd. xxxx is the 
type of error; it may be unrecoverable I/0, 
recoverable I/C, or device unavailable. 
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2-29 LOAD COMMAND 


The LOAD command is used to load a user’s task into memory. 
Format: 
LCAD [taskid,]fd[,segsize increment] 


Parameters: 


taskid specifies the name of the task to be loaded. 

fd specifies the file or device the task is being 
loaded from. 

segsize specifies amount of memory in Kb (above the 

increment memory Size) the task needs for processing. 


When a task is built (via Link), the OPTION 
WORK=n command adds additional memory to a 
task. The size field in the LOAD command 
overrides the amount of memory specified by 
Linke The size is accepted in .25kb 
increments. . 


Functional Details: 


In order to maintain CSS compatibility, a background (.BG) task 
alsc can be loaded into memory. Any valid taskid can be entered 
but will be ignored. . 


If a task is loaded from a direct access device, the system first 
searches the user volume or the specified volume under the user's 
account. If the file is not found in the search, the system 
automatically looks for the file on the system volume in the 
system account. If only the fd is specified in the LOAD command, 
the extension .TSK is assumed. The LOAD command can be entered 
in command mode. 


NOTE 
The LOAD command loads the task file <fd> 
into the terminal user's segment. The 


TASK and the OPTION commands are ignored 
if the task is currently loaded. 
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Exaasples: 


IL VOL: CAL 


L PTRP: 


Messages: 


FLT-ERR 

FORM-ERR 
LOAL-ERR 
MNEM-ERR 
PARM-ERR 


SEQ-ERR 


Load the task from file 


Load a task 
reader punch 


File descriptor syntax 
Command syntax error 
Load failed for reason 
Incorrect command name 
Operand syntax error 


Task already loaded 


from the paper 
device. 


error 


noted in TYPE field 
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VOL:CAL.TSK. 


tape 
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2.30 LOG COBBAND 


Ce a am OD am ae aE a on om am a 


The LOG command logs all user input and MTM reSponses to a 


specified fd. 


Format: 


fief feel] Ec 


Parameters: 


fd 


COPY 


NOCOPY 


Functional Details: 


is the file descriptor of the log file or 
device. If no fd is specified, logging is 
terminated. If fd is a file, it must be 
previously allocated. Files are assigned EWO 
privileges so that logged output is added to 
the end cf the file. If a log is active when 
another LOG command is entered, the old log is 
closed and the new one is initiated. 


specifies that all output is written to both 
the terminal and the log device. 


specifies that all output (except messages) is 
written to the log device and not to the 
terminal. Messages from other users and the 
operatcr are written to both the terminal and 
the log device. If this parameter is omitted, 
COPY is the default. 


is a decimal number from 0 through 65,535 
specifying the number of lines after which the 
user log file is to be checkpointed. If this 
Parameter is omitted, the default is 15 lines. 
If n is specified as 0, no checkpointing will 
OCCULe 


Checkpointing is only meaningful for indexed files on disc. The 


LOG command can be 


entered in command mode, task loaded mode, and 


task executing mode. 
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Example: 


LOG 


Messages: 


ASGN-ERR 
FD-ERR 
FORM-ERR 


MNEM~-ERR 


LOG.FIL,COPY,10 


Log file could not be assigned 
File descriptor syntax error 
Command syntax error 


Incorrect command name 
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2031 MESSAGE COMMAND 


The MESSAGE command sends a message to a specified usere 


Format: 
userid 
MESSAGE message 
2CPERATOR 
Parameters: 


userid. is the name of the user the message is being 
“pg sent to. This id can be obtained from the 
DISPLAY USERS command. A userid of .OPERATOR 
sends a message to the system console. 
message is the text of the message that the user wants 
to send. 
Functional Details: 
The user receiving the message receives the userid of the sender 
as well as the message. 
This command can be entered in command mode, task loaded smode, 
and task executing mode. 
Example: 
The following message is sent to userid "AVE" from userid “TK". 
The format of the message sent is: 
ME AVE HELLO MTM USER 


The format of the message received is: 


TK-HELLO MTM USER 
Message: 


USER-ERR Userid not currently signed on 
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2-32 MODIFY COMMAND 


The MOCLDIFY command modifies the contents of a memory location in 
the loaded task. 


Formats: 


Parameters: 


address is the halfword boundary address at which the 
contents of memory are to be modified. 


data is a data field consisting of zero to four 
hexadecimal digits that represent a halfword 
to be written into memory starting at the 
locaticn specified by address. Any string of 
data less than four characters is 
right-Jjustified and left-zero filled. If the 
comma is entered but data is omitted, 0O is 
entered into one halfword. 


Functional Details: 


This command causes the contents of the halfword location 
specified by address (mcdified by any previous BIAS command) to 
pe replaced with data. The modify address must be aligned on a 
halfword boundary. 


The MODIFY command can be entered in task loaded mode and task 
executing mode. 


Any segment (impure, shared, or task common) to which u-task has 
write access can be modified. Only the impure segment can be 
modified for an e-task. 
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Exargples: 


BI 0O 


Modifies four halfwords at location 


MOD 12F0,4,0,4,0 12FO to contain 0004 0000 0004 


MOT (£0000,4 


Messages: 


ADRS-ERR 


FORM-ERR 
MNEM-ERR 
NCPR-ERR 
ROLL~ERR 


TASK-ERR 


48-043 ROO 


5/81 


0000. 
Modifies the first halfword of the 


task common linked to the task using 
segment register D to 4. 


Addres¢é net halfword boundary aligned or not 
in a writable segment of the loaded task 


Command syntax error 


‘Incorrect comnand name 


Missing cperand 
Task currently rolled out 


No task loaded 
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2-33 OPTIONS COMMAND 


The CPTICNS command allows an MIM user to change the task options 
of the currently loaded task. 


Formats 


AFPAUSE SYCPAUSE 
CPTICNS : [- 
AFCONTINUE 


Parameters: 


AFFAUSE 


AFCONTINUE 


SVCPAUSE 


SVCCONTINUE 


NONRESIDENT 


Functional Details: 


j= 


ONRESIDENT | 


specifies that the task is to pause after any 
arithmetic fault. 


specifies that if the arithmetic fault (AF) 
trap enable bit is set, a trap is taken. If 
the bit is not set, the task continues after 
an arithmetic fault occurs, and a message is 
sent tc the log device. 


specifies that SVC 6 is treated as an illegal 
SVC (applies to background tasks only). If an 
SVC 6 is executed within a background task, 
the task is paused. 


specifies that SVC 6 is treated as a NO-OP 


(applies to background tasks only). If an SVC 
6 is executed within a background task, the 
task is continued. 


specifies that the task is to be removed from 
memory at end of task. 


The CPTICNS command can be entered in task loaded mode. 


Examples: 


CPT AFC,SVCC 


48-043 ROO 5/81 


Messages: 


FCRM-ERR Command syntax error 
PARM-ERR Operand syntax error 
TASK=-ERR No currently selected task 
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2-34 PAUSE COMMAND 


The PAUSE command pauses the currently running task. 
Format: 

PAUSE 
Functional Details: 


Any I/0 proceed, ongoing at the time the task is paused, is 
allowed to go to completion. This command is rejected if the 
task is dormant or paused at the time it is entered. 


The FAUSE command may be entered in task loaded mode and task 
executing mode. 


Messages: 

FORM-ERR Command syntax error 
MNEM-ERR Incorrect command name 
SEQ-ERR Task paused 


SVC6€-ERR POS=rFORM Task dormant 


TASK~ERR No.task lcaded 
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2-35 PREVENT COMMAND 


The PREVENT command suppresses either messages or the hyphen (-) 
prompt while an interactive task is running. 


Forgrat: 
MESSAGE 
PROMPT 
PREVENT 
fs ae ie 
SVARIABLE 


If a terminal user has not input either of these commands'7 then 
the terminal will receive both sessages and (-) prompts. The 
hyrhen prompt indicates that either a task or CSS is executing. 


Parameters: 
MESSAGE prevents other MIM users from being able to 
send messages to the user terminal. 
PROMPT suppresses the printing of the hyphen (-) 
prompt during task executing mode. 
ETM supresses the display of end of task message. 
SVARIABLE disables variable processing on a per user 


basis. 


Functional Details: 


If the MTM system includes variable support, and the SVARIABLE 
parameter is entered, the overall performance of MTM increases. 


Messages: 

FORM-ERR Command syntax error 
MNEM-ERR Incorrect command name 
PARM~ERR Operand syntax error 
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2.36 PRINT COMMAND 


The PRINT command s 
(spool print queue) 
will actually print 


Format: 

PRINT fd[, DEVIC 
Parameters: 

fd 

DEVICE= 


CCPIES= 


DELETE 


VFC 


Functional Details: 


If the spool option 
will result in ane 


The PRINT command c 


ends the data to be printed to a pseudo device 
to be subsequently sent to the device that 
the file. 


E=pseudo device] [,CQPIES=n] [,DELETE] [,VFC] 


is the name of the file to be printed. 


pseudo device specifies the print device. If 
this parameter is omitted, output is directed 
to any available print device. 


h allows the user to specify the number of 
copies cf the file fd to be output. If this 
argument is omitted, one copy is the default. 


specifies the file fd is to be deleted after 
the outrut operation is completed. If this 
argument is omitted and the file is not a 
spool file, the file is retained. 


specifies that vertical forms control is in 
uS@e 


was not selected at sysgen time, this command 
FOr. 


an be entered in a command mode, task loaded 


mode, and task executing mode. 


Messages: 


FD-ERR 


FORM-~ERR 


Invalid file descriptor 


Command syntax error 
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MNEM-ERR 
SVC 6-ERR TYPE=NMSG 
SVC 6-ERR TYFE=PRES 


SVC 6-ERR TYPE=QUE 
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Incorrect Command name 
Spooler did not receive message 
Spooler not loaded 


Spooler is dormant 


2e37 PUNCH COMMAND 
The PUNCH command i 
file is to be punch 
Format: 

PUNCH fa[, DEVIC 


Parameters: 


fd 


DEVICE= 


COPTES= 


DELETE 


VFC 


Functional Details: 


If the spool option 


ndicates to the Spooler that the specified 
ede 


E=pseudo device] [,COPIES=n] [DELETE] [,vFc] 


is the name of the file to be punched. 


pseudo device specifies the name of the pseudo 
output device. If the DEVICE= parameter is 
omitted, punch output is directed to any 
available punch device. 


nis the number of copies desired. If the 
COPIES= parameter is omitted, only one copy 
is output. 


specifies that the fd is to be deleted after 
the output operation is performed. Lf 
omitted, the file is retained. 


specifies that vertical forms control is in 
usee 


was not selected at sysgen time, this command 


will result in an error. 


The FUNCH command can be entered in command mode, task loaded 
mode, and task executing mode. 


Messages: 


FD-ERR 


FORM~ERR 


2-72 


Invalid file descriptor 


Command Syntax error 
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MNEM-ERR 
SVC 6-ERR TYPE=NMSG 
SVC 6-ERR TYFE=PRES 


SVC 6-ERR TYPE=QUE 
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Incorrect command name 
Spooler did not receive message 
Spooler not loaded 


Spooler is dormant 


2e38 RENAME COMMAND 
The RENAME command changes the name of an unassigned, direct 
access file. 
Format: 
RENAME oldfd,newfd 


Parameters: 


oldfd is the current file descrirtor of the file to 
be renamed. 

newfd is the new file descriptor to which the file 
is renamed. 


Functional Details: 


The volume id field of the new file descriptor (newfd) may be 
omitted. A file can only be renamed if its write and read 
protection keys are 0 (X‘'Q000"). 


The RENAME command may be entered in command mode, task loaded 
mode, and task executing mode. 


Examples 


REN VOL: AJMeCUR,AJM.NEW Renames file AJM.CUR to AJM.NEW on 
volume VOL. 


Messages: 

ASGN-ERR File descriptor currently assigned or the 
TYPE=PRIV RENAME directed to the system console 

PcS=fd 

FD-ERR Invalid file descriptor 

FORM-ERR Command syntax error 
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MNEM-ERR 
PARM-ERR 
RENM-ERR 


TYPE=NAME 
POS=fd 
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Incorrect command name 
Operand syntax error 


File renamed to existing file 


2-39 REPROTECT COMMAND 


The REPROTECT command sodifies the protection keys of an 


unassigned, direct 


Format: 


access file. 


REERCTECT fd,new keys 


Parameters: 


fd 


new keys 


Functional Details: 


is the file descriptor of the file to be 
reprotected. 


is a hexadecimal halfword whose left byte 
signifies the new write keys and whose right 
byte signifies the new read keys. 


Uncenditionally protected files can be conditionally reprotected 


or unprotected. 


The REPROTECT command can be entered in command mode, task loaded 
mode, and task executing pode. 


Messages: 


ASGN-ERR 


FD-ERR 
FORM-ERR 
MNEM-ERR 
NOPR-ERR 
PARM-ERR 


REPR~ERR 


Reprotect failed for reason noted in TYPE 
field 


Invalid file descriptor 
Command syntax error 
Incorrect command name 
Keys nct specified 
Operand syntax error 


Reprotect failed for reason noted in TYPE 
field 
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ASGN and REPR error TYPE field responses: 


NAME File descriptor does not exist on 
volume 

PRIV File descriptor currently assigned 

VOL Volume or device does not exist 
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specified 


{ and RW | 

2-40 REWIND AND RW COMMANDS 

The REWIND and RW commands rewind magnetic tapes, cassettes, and 
direct access files. 


Format: 


REWIND [£a,] 10 
or 


RW [fa] lu 
Parameters: 


fd is the file descriptor of the device or file 
to be rewound. 


‘lu is the logical unit to which the device or 
file is assigned. If lu is specified without 


fd, the cperaticn is performed on the lu 
regardless of what is assigned to it. 


Functional Details: 


The REWIND and RW commands can be entered in task loaded mode. 


Examples: 
REW 1 Causes the file or device assigned 
to lu 1 to be rewound. 
REW M300:AJM.OBJ,4 Causes file AJM.OBJ, as assigned to 


lu 4 on volume M300, to be rewound. 
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SPS ute ith Heal Seana tee Mb 


Messages: 

ASGN-ERR | File or device eoaia not be assigned for the 
reason nected in the TYPE field 

FORM-ERR Command syntax does seeoinestel 

I/0-ERR I/O error encountered on the specified device 
or file 

LU-ERR Invalid file descriptor encountered 

MNEM-ERR Incorrect conmand hame 

TASK-ERR No task loaded 


ASGN error TYPE field responses: 


NAME File descriptor does not exist on specified 
volume 

PRIV File or device already assigned 

VOL Volume or device does not exist 
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2-41 RVOLUME COMMAND 


The RVOLUME command enables an MTM user to allow/disallow access 
to a privately owned disc. 


Format: 


RVOLUME voln, 


Parameters: 


voln 


ADL 


actno 


RW 


ADD, 
RW 
RO 
RW RW 
actnoy|/ geooe rs aCtNOrcG6 |/ 
RO RO 
REMOVE, 
RW 
ALLA 
BO 
actno 
USERS _ eo dactno, - actno>2 


is the volume name of the restricted disc. 


indicates that the specified accounts will 
have access to the restricted disc. 


is a decimal number from 0 through 295 
indicating the accounts allowed/disallowed 
access tc the restricted disc. If ALL is 
specified, accounts 0 through 255 have access 
to the restricted disc. 


indicates that the specified account has 
read/write access to the restricted disc. If 
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this argument is omitted, the default is read 
only. 


RO indicates that the specified account has’ read 
only access to the restricted disc. 


REMOVE indicates that the specified accounts are 
disallcewed access to the restricted disc. If 
ALL is specified, all. accounts having access 
to the restricted disc are disallowed access 
with the exception of the owner's account. 


USERS displays all accounts having access to the 
restricted disc along with: the access 
privileges. 


Functional Details: 


A disc marked on as a SYSTEM disc is treated as a restricted 
disc. Account number 255 is the owner. 


The owner of a private disc can allow/disallow other MTM users, 
the system operator, and other non-MTM tasks access to the 
restricted disc. 


If an owner enters a REMOVE parameter specifying his own account, 
he will be denied access to the disc; but as owner, can still add 
accounts, remove accounts, and display accounts that have access 
along with the respective access privileges. 


For a user with RW access to a restricted disc, accessing 
private, group, and system files is exactly the same as accessing 
files on any other disc. 


For a user with RO access to a restricted disc, accessing group 
and system accounts is the same as accessing files on any other 
disc. Files within the user's private account can only be 
assigned SRO or ERO. The user cannot allocate, rename, 
reprotect, or delete any files. 


Once a restricted disc is dismounted by the system operator, any 
accounts that once had access no longer have access privileges. 
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Exar 


ACCT 


FORM 


PARM 


PRIV 


VOLN 


O/RC 1/R0O 2/RC 3/R0 4/RO 6/RO 
7/R0 8/RC 9/RC 10/R0O 11/7R0O 12/R0 13/R0 
14/R0O 15/RO 16/RC 17/RO 18/RO 19/RO 20/RO 
252/R0 253/R0 2E54/RO 255/R0 
RVCL FIXCD,R,ALL 
RVOL FIXC,U 
82/RW 
RVCL FIXD,A,ALL/RW 
RVOL FIXC,U 
O/RW 1/RW 2/RW 3/RW u/RW 6/RW 
T/RW 8/RW S9/KW 10/RW 11/RW 12/RW 13/RW 
14/RW 15/RW 1€/RW 17/RW 18/RW 19/RW 20/RW 
252/RW 253/RW 254/RW 255/RW 
RVOL FIXLD,R,ALL 
RVOL FIXC,U 
82/RW 
ages: 
-ERR Account number specified is not between 0 and 
255 
-ERR Format of the command is invalid 
- ERR Invalid parameter specified parameter 
missing in the RVOLUME command 
-ERR MTM user without access privileges tried to 
. access a restricted disc 
-ERR Volume srecified not online or name 
invalid. 
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ples: 


RVCL FIXD,U 

4/RW 20/RW TT/R¥ 82RW 
RVOL FIXD,A,ALL 
RVOL FIXTL,U 


2-42 SEND COMMAND 


The SEND command sends a message to the bixventig selected task. 
Fornat: 

SEND message[;] 
Parameters: 

message is a 1i- to 64-character alphanumeric string. 
Functional Details: 


The message is passed to the selected task in the same manner as 
an SVC 6 send message. Following standard SVC 6 procedures, the 
message consists of an 8-byte taskid identifying MTM as the 
sender, followed by the user~supplied character string. The 
message passed to the selected task begins with the first 
nonblank character following SEND and ends with a carriage return 
or semicolon (3) as a line termination. A message cannot be sent 
to a task currently rolled cut. 


The receiving task must have intertask message traps enabled in 
its TSW and must have established a message buffer areae Refer 
to the OS/32 Supervisor Call (SVC) Reference Manual for more 
infcrmation on the send message function (SVC 6). 


The SEND command can be entered in task executing mode. 
Exaumples: 
SEND CLOSE LU2,ASSIGN LU3 


The following is received by the task: 


oMTM CLOSE LU2, ASSIGN LU3 
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Messages: 


ARGS-ERR 


MNEM-ERR 


NCPR-ERR 


SVC6E-ERR 


TASK-ERR 


Message exceeded 64 characters 
Incorrect command name 


No message waS provided. The first nonblank 


character following the SEND command was a 
carriage return. 


SVC 6 error returned indicating the task could 
not receive a message trap 


No task loaded 
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2043 SIGNOFF COMMAND 
The SIGNOFF command terminates the terminal session. If a user 
Signs off when a task is loaded, the task is cancelled. 
Format: 
SIGNOFF 


Functional Details: 


When a terminal user signs cff the system, these messages are 
disrlayed: 


ELAPSED TIME=hh:mm:ss CPUTIME=utime/ostime 
SIGNON LEFT=hh:mm:ss CFU LEFT=hh:mm:ss 
TIME OF F=mm/dd/yy hhsmmsss 


The SIGNOFF command can be entered in command mode, task loaded 
mode, and task executing mcde.w It cannot be followed by another 
command on the same command line. 


Message: 


MNEM-ERR Incorrect command name 
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2.46 


SIGNON COMMAND 


The SIGNON command allows a user to communicate with MTM. No 
commands are accepted until a valid SIGNGN cogmand is entered. 


Fors 


Para 


at: 


| fd 
SIGNON userid [-actno,paseword)| HY TRONNENT=| 


NULL [3] 


(- CPUTIME=maxtine] 


{,classid=iocount, [,..-,classid=iocount 32}] 


meters: 
userid 
actno 
password — 


ENVIRONMENT= 


is a 1- to 8-character alphanumeric string 
specifying the terminal user's identification. 


is a 3-digit decimal number from 1 through 250 
specifying the terminal user's account number. 


is a 1- to ‘4t2*character alphanumeric string 
specifying the terminal user’s password. 


fd is the file descriptor specifying an 
existing file that will establish the user's 
environment at signon time. 


NULL specifies that the signon CSS = routine, 
USERINIT.CSS, should be ignored and the user 
will establish the environment at signon time. 


If the entire keyword parameter is omitted, 
MTM searches all online discs for the signon 
CSS procedure USERINIT.CSS/P. The system 
volume, system account, is searched last. If 
USERINIT.CSS is found, MTM calls the CSS and 
executes the routine. If it is not found, MTM 
enters ccmmand mcde. ; 
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CPUTIME= maxtime is a decimal number specifying the 
maximum CPU time to which the job is limited. 
If this farameter is omitted, the default 
established at sysgen time is used. If 0 is 
specified, no limits are applied. The 
parameter can be specified as: 


mmmm:ss 
hhhh:mmess 
sses 


classid= is one of the &-character alphanumeric 
mnemonics specified at sysgen time associated 
with each specified device or file class. 
iocount is a decimal number specifying the 
maximum number of I/0 transfers associated 
with a particular device class to which the 
job is limited. If this parameter is omitted, 
the default established at sysgen time is 


usede If 0 is specified, no limits are 
applied to that class. 


Functional Details: 


The SIGNON command can be entered in command mode. It cannot be 
followed by another command on the same line. 

When ENVIRONMENT=NULL is specified, the colon is optional. This 
allows the user the ability to specify the null device (NULL:). 


Examples: 


SIGNON ME,12,PASSWD 
SIGNCN ME,118,SWDOC,ENV=NULL 


SIGNON ME,118,SWDOC,ENV=XYZ 


Messages: 


DUPLICATE USERNAME Userid already in use 

FCRM-ERR Command syntax error 

INVALIL ACCOUNT . Invalid or unrecognized account number 
INVALID PASSWORD Fassword invalid 
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MISSING PASSWORD 


SEQ-ERR 


SIGNON REQUIRED 


USERNAME SYNTAX ERROR 
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Lo a a ca 


Fagsword omitted 


SIGNON command entered when user is 
already signed on 


Attempt to enter a command before signon 
or mistake in SIGNON command 


Userid invalid 
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2°45 START CCMMAND 


The START command initiates execution of a dormant task. 


Format: 


Parameters: 


address 


address 


parameter 


Functional Details: 


Hl [-parametery,+++,parametera]| 


specifies the address at which task execution 
is to -Legine For user tasks, this is not a 
physical address but is an address within the 
task's own programe For executive tasks, it 
is a physical address. If address is omitted 
or is 0, the loaded task is started at the 
transfer address specified when the task was 
established. | 


specifies optional parameters to be passed to 
the task for its own decoding and processing. 
All user specified parameters are moved to 
memory keginning at UTOP. If no parameters 
are specified, a carriage return is stored at 
UTOP. 


The START command can be entered in task loaded mode. 


Exargples: 
ST 138 Starts the currently selected task 
at X¥°138°. 
ST 100,NOSEG,SCRAT Starts the currently selected task 


ST ,1000,ABC 
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at X*100° and pass NOSEG,SCRAT to 
the task. 


Starts the currently selected task 
at transfer address and pass 
1000,AEC to the task. 


Hessages: 


FORM-ERR Command syntax error exists 

MNEM-ERR Incorrect command name specified 

PARM-ERR Operand pyntae arcoe exists 

SVC6-ERR Insufficient memory between UTOP and CTOP to 
TYPE=ARGS pass all parameters 

TASK-ERR No task loaded 
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2046 TASK COMMAND 


The TASK command maintains CSS compatibility of MTM to the 


Operating system. No specific action is performed by this 
comsand. 
Formats: 
taskid 
TASK 
«BGROUND 


Parameters: 
taskid is the name of the taskid that has been loaded 
into the foreground segment of memory. 
- BGROUND indicates that the task has been loaded as a 
background task. 


Examples: 


T BG 


T COPY 


Messages: 


MNEM-ERR Incorrect command name specified 


PARM-ERR Operand syntax error exists 
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2-47 TEMPFILE COMMAND 


The TEMPFILE command allocates and assigns a temporary file to an 
lu for the currently selected task. A temDdorary file exists only 
for the duration of the assignment. Wher a temporary file is 


clos 


ed, 


Format: 


Para 


TEMPFILE lu, 


meters: 


lu 


CONTIGUOUS 


fsize 


INDEX 


lrecl 


bsize 


Cc 


IH 


it is deleted. 


ONTIGUOUS,fsize 


eerie aa ‘ ee . i 


is a decimal number specifying the lu number 
to which a temporary file is to be assigned. 


specifies that the file type to be allocated 
is contiguous. 


is a decimal number specifying the total 
allocaticn size in 256-byte sectors. This 
size can be any value up to the number of 
contiguous free sectors existing on the 
specified volume at the time the command is 
entered. 


specifies that the file type to be allocated 
is indexed. . 


is a decimal number specifying logical record 
length in bytes. It cannot exceed 65,535 
bytes; its default is 126 bytes. 


is a decimal number specifying the number of 
256-byte sectors contained in a physical block 
to be used for buffering. If bsize is 
omitted, the defavlt value is 1. bsize cannot 
exceed the maximum block size established at 
sysgen time. 
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isize is a decimal number specifying the index block 
BS size in 256-byte sectors. If isize is 
omitted, the default value is 1. isize cannot 
exceed the maximum block size established at 

sysgen time. 


Functional Details: 


A temporary file is allocated on the temporary volume. 


To assign this file, sufficient room must exist in system space 
for three buffers, each cf the stated size. Therefore, if bsize 
or isize is very large, the file cannot be assigned in some 
situations. A maximum biock size parameter is established in the 
System at sysgen time. The bsize and isize cannot exceed this 
constant. 


The TEMPFILE command can be entered in task loaded mode and task 
executing mode. 


Exagpples: 


TE 2,C0,64 Allocates, on the temporary volume, 
a contiguous file with total length 
of 64 sectors (16kb) and assigns it 
to the loaded task‘s lu 2. 


TE 14,1N,126 Allocates, on the temporary volume, 
an index file with logical record 
length of 126 bytes. The buffer 
size and index block size default to 
one sector. The file is assigned to 
lu 14 cf the loaded task. 


Messages: 

ALLO-ERR Allocaticn failed for reason denoted by TYPE 
field 

FCRM-ERR Command syntax error 

LU-ERR | Invalid logical unit number or logical unit 
assigned 

MNEM-ERR Incorrect command name 

NOPR-ERR Required operand missing 
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PARM-ERR 


SPAC-ERR 


TASK-ERR 


2-94 


Operand syntax error 


Task exceeds established maximum system 
usage 


No task loaded 
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{| VOLUME | 


2-48 VOLUME COMMAND 


The VOLUME command sets or changes the name of the default user 
volume. It may also be used to query th= system for the current 
hames associated with the user system, reil, spool, or temporary 
volume. 


Formats: 
VOLUME voin| 


Parameter: 


voln is a 4Yecharacter volume identifier. If this 
parameter is omitted, all current default 
uSeL, system, roll, spool, and temporary 


volume names are displayed. 
Functional Details: 


Any commands that do not exrlicitly specify a volume name use the 
default user volume as a default. No test is made to ensure that 
the volume is actually online at the time the command is entered. 
If voln is not specified, the names of the current default 
volumes are output to the user’s terminal. 

The default user volume is initially set to the system volume 


when the user first signs cne The VOLUME command can be entered 
in command mode, task executing mode and task loaded mode. 


Examples 


VOL 
USR=MTM SYS=MTM SPL=M67B TEM=M301 RVL=MTM 


Messages: 


MNEM-ERR Incorrect command name 


PARM-ERR Operand syntax error 
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20-49 WFILE COMMAND 


The WFILE command writes a filemark on magnetic tapes, cassettes, 
and direct access files. 


Format: 

WILE [¢a,] 10 
Parameters: 

fd 


lu 


is the file descriptor of the file or device 
to which a filemark is to be written. 


is the lu to which the device or file is 
assigned. If lu is specified without fd, the 
operation is performed on the specified lu 


regardless of what is assigned to it. 


Functional Details: 


The WFILE command can be entered in task loaded mode. 


Exarpless: 
WF 1 Causes a filemark to be written on 
the device or file assigned to lu ‘1. 
WF M300: AJM.OBJ,4 Causes a filemark to be written on 
file AJM.OBJ, which is assigned to 
lu 4 on volume M300. 
Messages: 
ASGN-ERR File or device could not be assigned for 
reason nected in the TYPE field 
FORM-ERR Command syntax error encountered 
I/O-ERR I/O error encountered on the specified device 


or file. 
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LU-ERE 
MNEM-ERR 
PARM-ERR 


TASK-ERR 
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Invalid legical unit encountered 


Incorrect command name 


Operand syntax error encountered 


No task loaded 


2-50 XALLOCATE COMMAND 


The XALLOCATE command is used to create a direct access file. 


Format: 


XALLOCATE fa, 


Parameters: 
fd 
CONTIGUOUS 


fsize 


INDEX 


lrecl 


keys 
CCONTIGUCUS,£fsize MH 


| loose 


is the file descriptor of the file to be 
allocated. 


specifies the file type to be allocated is 
contiguous. 


is a decimal number indicating file size which 
is required for contiguous files. It 
specifies the total allocation size in 
256-byte sectorse This size may be any valve 
up to the number of contiguous free sectors 
existing on the specified volume at the time 
the command is entered. 


specifies the file type to be allocated is 
indexed. 


is a decimal number specifying the logical 
record length of an indexed file or 
communications device. It cannot exceed 
65,535 Lytese Its default is 126 bytes. It 
may optionally be followed by a -slash (/) 
which delimits lrecl from bsize. 
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bsize is a decimal number specifying the number of 
256-byte sectors contained in a physical block 
to be used for buffering. This parameter 
cannot exceed the maxigum block size 
established at sysgen time. If bsize is 
omitted, the default value is one sector. 


isize is a decimal nugber specifying the indexed 
block size... If isize is omitted, the default 
value is one sector. like bsize, isize cannot 
exceed the maximum block size established at 
sysgen tine. 


ITAMN . specifies the device to be allocated is a 
communications device. 


keys specifies the write and read protection keys 
for the file. These keys are in the form of 
a hexadecimal halfword, the left byte of which 
Signifies the write key and the right byte the 
read key. If this parameter is omitted, both 
keys default to 0. 


Functional Details: 


The XALLOCATE command differs from the ALLOCATE command in the 
following manner. If the fd to be allocated is a device name 
instead of a filename, the command is checked for syntax only. 
If fdis an existing file, it is deleted and reallocated. If fd 
does not exist, it is allocated. This command permits the user 
to have CSS. procedures that will allow either a file or device 
Mame to be specified. If a filename is specified, the XALLOCATE 
command reallocates the file. 


The XALLOCATE command may be entered in command mode, task loaded 
mode, and task executing pode. 


Messages: 

ALLO-ERR Allocation failed for reasons denoted by TYPE 
field 

FD-ERR Invalid file descriptor 

FORM-ERR Command syntax error 

MNEM-ERR | Incorrect command name 

NOPR-ERR , Required operand missing 

PARM-ERR Invalid rfarameter 
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2051 XDELETE COMMAND 
The XDELETE command is used to delete one or more files. If the 
file does not exist, no error is generated. : 
Format: 
XDELETE £4, (£4, re rf dal 


Parameter: 


fa is the file descriptor of the file to be 
deleted. 


Functional Details: 
LA 


A file can only be deleted if it is not currently assigned to a 
task and its write and read rrotection keys are 0 (X‘0000'). 


Exauple: 
XDEL FIXD:08S323240.817,RADPROC.FIN 


Messages: 


DELE-ERR Delete failed for reason noted by TYPE field 
FD-ERR Invalid file descriptor 

MNEM-ERR Incorrect command name 

NOPR-ERR No operand specified 


DELETE error TYPE field resrenses: 


PRIV File currently assigned to a task 
PROT Read/write protection keys not 0 
VOL Specified volume not mounted 
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CHAPTEE 3 
PROGRAM DEVELOPMENT COMMANDS 


3e1 INTRODUCTION 


The program developrent coasgands allow a user to: 


® specify an existing source file or allocate a new source file 
to be operated on when a program development command is 
entered. This source file is called the current program. The 
commands performing this function are the EDIT command and any 
‘- OF the language commands. 


® keep files current throughout a developraent effort. The 
program development cosgmands date check the object and image 
files with the source file and perform a compile, link, and 
execute, or run when necessary. The commands performing these 
functions are: COMPILE, COMPLINK, EXECUTE, LINK, and RUN. 


® manipulate files when more than one file is involved in a 
development effort. The cormmands perforasing this function 
ares ADD, ENVIRONMENT, LIST, and REMOVE. 

3-2 MAINTAINING LANGUAGE-DEPENDENT INFORMATION 

During a developrent effort, pertinent language-dependent 

information can be a,aintained in order to reduce the amount of 

information a user pust enter. By using the appropriate language 
command (see Table 3-2), the following information can be 

invoked: . 

@ Standard extensions for source files 

@ Tab settings when a user is in edit node 

e The compiler to be used 

e The run time library to be linked 

When a filename is specified in a language command, the systen 

searches the appropriate volume for the source file. If the 


source file is found, it becomes the current program and is ready 
to be used. If the source file is not found: 


48-043 ROO 5/81 . 3-4 


1. A file named filename.ext is allocated on the specified 
volume or the default volume. 


2. The following message is displayed: 
£5 ef FILE £4 is ALLOCATED 


3. The newly created source file becomes the current progran. 
4 The appropriate language-dependent information is invoked. 


5. The editor is entered with the newly created source file 
ready to be used. 


If a filename is not specified with the language command and n0 
other command was previously specified, the single-rodaule 
environpent is entered. Specification of a filenane is 
accomplished through the progras development commands. 


3-3 DEVELOPING A PROGRAM 
A user can develop a prograrg in one of two ways: 
; f 
e The entire program can be contained in one file. This is 
called a single-module environrent. 


e The program can be contained in several files. This is called 
a multi-module environment. 


Not all program development commands are valid in both types of 
environments as shown in Table 3-1. 


TABLE 3-1 PROGRAM DEVELOPHENT 
COMMANDS 


COMMAND { MODULE | MODULE 


{ { 
| 1 
{ SSS SM Sesser er sestesszsocssesresse | 
{ ADD i x ! 
| COMPILE } x {x | 
{| COMPLINK {x {x | 
{| EDIT } x {x 1 
| ENVIRONMENT | x |x " 
} EXECUTE {x {x ! 
{ LINK | x | x | 
} LIST { {x ' 
} REMOVE ! { x { 
| RUN {x {x H 
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| | STANDASD SOURCE 
{ LANGUAGE | COMMAND SYNTAX } FILE EXTENSIONS 
SESssr ese s SSS SS SVS TBST SSS VSS 22S ESE2 35 SRSS SSS SSSSSrsssessesseSesesesse= 
1 CAL CAL [[von i] fil enane] eCAL 
| CAL Hacro MACRO [[voint] filename] | -4AC 


ae . 
é oy Hy Tae SA, a ait 
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If a command is meaningful only in the multi-aodule environrent 
but is entered in the single-module environment, the following 
message is displayed: 

, 


*** NOT IN MULTI-MODULE ENVIRONMENT 


the on 


‘If a development command such as EDIT, COMPILE, COMPLINK, or EXEC 


is ‘entered without first invoking th. congasge Scpenseat 
information, the following message is displayed: | 


and 


[##*® LANGUAGE ENVIRONMENT NOT SET 


For sone commands, specifying a filename to identify the current 


program is only meaningful in a single-module environment. If 
entered in a multi-module environment, it is ignored. 


30301, The Single-Module Environment 


Following is a general description of what occtrs when a command 
is entered in a single-module environment. 


‘K single-nodule environment is accessed by first entering a 


language command (see Table 3-2). 


TABLE 3-2 LANGUAGE COMMANDS 


FORTRAN VII FORT [froan:] filenane| eFTN (developrent) 


eFIN Coptimizing) 


COBOL COBOL [[v° 1n:] filename] -CBL 


REPORT eRPG 
PROGRAM 
GENERATOR 


RPG [ [von ]] filenane | 


( 
| 
{ 
{ 
{ 
| | 
FORTRAN VII | FORTO [[voan:] filenane] 
| 
l 
{ 
{ 
{ 
{ 
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{| When a conmand is entered and a filename is specified, the system 
{ searches the appropriete volume for the source file. If the 
f source file is not found, the following message is displayed: 


*** FILE fa NOT FOUND 


If the source file is found, it becomes the current program. The 
system searches for the corresponding object file and date checks 
to ensure that it is cucrent with the sorvrce file, If no obsect 
file exists or it is not current with the so.sze file, the source 
file is compiled. Depending on the command entered, the systen 
then searches for the task image file. If the task image file 
does not exist or is not current with the object file, the object 
file is linked. If all files are current, no action is taken. 
Depending on the command entered, once a current task image file 
exists it is loaded and run. The following message is displayed: 


| volns: filename EXECUTION FOLLOWS 


When a filename is not specified and a current program exists, 
the current program's source, object, or jmage file are date 
checked; and a compile, link, or execute is performed if 
necessary. If a current program does not exist, the following 
message is displayed: 


¢ 


4 
| *** CURRENT PROGRAM NOT SPECIFIED 


{ 3.3.2 The Multi-Module Environment 


{ Ina multi-module environment a user deals with several files 
{ that, at some point, are linked together to form one load module. 
{ Filenames are maintained in an environment descriptor file (EDF), 
{ that is created via the ENVIRONMENT command. Other information, 
{ such as the programming language each file is written in, is also 
jf maintained. As files are created or deleted, their filenames 
f must be added or removed from the EDF. 


Not all commands in a muiti-module environment need to have a 
filename specified. When these commands are entered, the 
requested operation is performed on all the files whose filenames 
are contained in the EDF. When a filename is specified, as in 
the case of COMPILE, RUN, and EDIT, the system makes sure that 
the specified filename exists in the EDF and performs the 
requested operation on that file. * 


Following is a general description of what takes place when a 
command is entered in a multi-nodule environment. 
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First, the system searches the appropriate volume for the EDF. 
Then it searches for all the files whose filenames are listed in 
the EDF. If all source files are not found, the following 
message is displayed: 


*** SOURCE FILE NOT FOUND { 


ade Ge 


If the source files are found, the system searches for all object 
files to date check to make sure they are cr“vent with the source 
files. If object files do not exist or are not -current, the 
corresponding source files are compiled. Depending on the 
command entered, the system then searches for the task image file 
to date check. If the task image file does not exist or is not 
current with the object files, the object files are linked. If 
all files are current, no action is taken. 


Once the task image file is current, it is loaded and run. The | 


following message is displayed: { 
voln: filename EXECUTION FOLLOWS | 
3.4 LINKING = 


If a link is involved in the operation requested by the user, the | 
following standard Link sequence is used by the systen: { 


ESTABLISH TASK 

INCLUDE current program : 
SHARED standard library for language 

MAP PR:,ADDRESS,ALPHABETIC 

BUILD filename .TSK 

END 


The user can supply a nonstandard Link sequence by allocating a | 
file on the appropriate volume named: | 


voln: filenane.LNK I 


In a single-aodule environment, filename is the filename of the 
current programe In a multi-module environment, filename is the 
filename of the EDF. 


If this file exists, the systen will use the nonstandard Link 
sequence rather than the standard Link sequence. 


@ 
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The 


following assumptions are made when linking in a multi-module 


environments: 


3.5. 


Files to be linked are in object code. 


The standard language “subroutine library is used for ail 
languages in the environment. 


‘No overlay structure is required. 


ASSIGNING LOGICAL UNITS 


There are three ways to assign logical units: 


1. 
Ze 


3. 


3-6 


Use the ASSIGN command. 


Use a standard command file, voinsfilename.ASN. The filename 


. portion of the command file is the filename of the EDF (see 
''- Section 3.7.5) in a multi-module environment and the filename 


of the current progran in a single-module environment. This 
command file is a CSS file that loads the task and makes the 
requested BRET GOR eNtee 


Preassign ptandaxd Or nonstandard pseudo devices within the 
signon command substitution systen (CSS) procedure, 
USERINIT.CSS. * In this case, the pseudo devices are 
associated with each lu. Table 3-3 shows pairings of logical 
units and pseudo devices. 


TABLE 3-3 LOGICAL UNIT (LU) AND 
PSEUDO DEVICE PAIRINGS 


| | PSEUGO | ' 
{| LU j] DEVICE | USE 
j[eesenenscsessesses Sseeccteszessie | 
{14 | OSSYSIN: { Input ] 
{ i - | ( 
| 2 | aSSYSOUT | Output ' 
{ j | | 
| 3 | @SSYSLIST | List i 
| | { | | 
{5 {| @SSYSCOM | Command input | 
{ ' | - ( 
{7 | @SSYSHSG | Messages { 
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The user assigns files and devices to the pseudo devices. 
Example: 


SSET OSSYSCOM=CON s: 


SSET OSSYSFaT=PR: 


See Chapter 5 for a description of the SSET varieble. 


These pseudo device assignments can be incorporated as part of 


the signon CSS, USERINIT.CSS. Once a user sets the pseudo 


devices, the lu assignments automatically are amade at signon 
time. If a change in devices is desired, the user need only 
assign another device to the pseudo devica. A user can make 
nonstandard assignments by using pseudo device names @aSYSLYI, 
aSYSLU2, through pseudo device name @SYSLU20. These nonstandard 
assignments supersede assignments using the pseudo device names 
listed in Table 3-3. 


3.6 LOADING AND RUNNING A TASK 


When a task is specified to be run, the system searches for the 
task image file, filenanme.TSK. If found, the task is loaded and 
run. The following message is then displayed: 


voln: filenane EXECUTION FOLLOWS 


If the task image file is not found, the command aborts, and the 
following message is displayed: 


TASK £d NOT FOUND 
When a filename is not specified, the task corresponding to the 
existing current program is loaded and run. 
If a current program does not exist, the command aborts, and the 


following message is displayed: 


**# CURRENT PROGRAM NOT SPECIFIED 
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3e7 PROGRAM DEVELOPMENT COMMANDS 


{| The progran development commands are: 


j o ADD 

! e CAL 

| e@ COBOL 

1 e@ COMPILE 
{ @ CONPLINK 
{} oe EDIT 


{ @ ENVIRONMENT or ENV 


[| e@ EXECUTE 
| @ FORT 

| © FORTO 

1 @ LINK 

{ eo ILISst 

} @ MACRO 


{| e@ REMOVE 
| oo RPG 


{ oo RUN 


{| The language commands in the list are described in Table 3-2. 
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367-1 ADD Command y ; { 
The ADD command adds a module to the EDF. 1 
Multi-Module Format: | 7 | ! 
apd fa [,cssprod] _— ; ! 
Paraneters: : . { 
fd is the file descriptor of the file to be added | 

to the EDF. | 

cssprod is the name of the css procedure to be used { 
when a nonstandard compilation procedure is { 

required. oe { 

Functional Details: { 


When the ADD command is entered, the current EDF is searched for | 
the specified fd. If the fd is found, the following message is | 
displayed: { 


#e* FILENAME CONFLICT: ENTRY NOT ADDED I 


If the specified fd is not found, it is added to the _ EDF. To { 
allocate the file on the user volume, see the EDIT command (see j 
Section 3.7.4). ! 


The cssprod parameter corresponds to the name of the CSS 
procedure to be used for compilation when a nonstandard 
compilation procedure is required. If the extension of the 
specified fd is the same as any one of the extensions listed in 
Table 3-2, cssprod does not have to be entered. If the extension 
of the specified fd is nonstandard (see Section 3.2), the cSsprod 
must be specified or the following message is displayed: 


*4* NON-STANDARD EXTENSION { 
If fd is omitted, the following message is displayed: | 
( 


eee SYNTAX ERROR 
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{ 327.2 COMPILE Command 


{ The COMPILE command produces an object. file from the source file 
{ - he current Prograhe 


| Single-Hodule Format: 


age 


‘COMPILE 


[voans] filenane 


TAS TN RT CG a ete ee ea atte te 


{ Multi-Module Fornat: 


} Para 


3-10 


COMPILE 


meters: 


volns 


filename 


ALL 


[voan:] filename \ 


ALL 


Current progres. 


is a  1%- to 4-character alphanumeric name 
specifying the volume on which the source file 
resides. If volns is not specified, the 
default is the default user volume. 


is a  1- to S8echaracter alphanumeric name 
specifying the current program. If a filenane 
is opitted in a single- or amulti-module 
environment, the existing current program is 
corapiled. 


specifies that all files in a arnulti-module 


environment are date checked and compiled if 
necessarye 
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3e7e3 COMPLINK Command | i { 


The COMPLINK command date checks source, object, and image files 
of the current program and performs a compile and/or link if 
necessarye 


Single-Module Format: . : 


[voin}] filename | 

COMPLINK = Sete ( 

current progran: ! 

Multi-Module Format: aa i 

COMPLINK { 

Paraneters: be | . 4 
volns is a 11- to 4-character alphanumeric name 


| 
specifying the volume on which the source file | 
resides. If voln: is not specified, the | 
default is the default user volume. ! 


filename ds a 1- to 6-character alphanumeric name | 
specifying the current program. Specification | 
of a filename is only meaningful in a | 
Single-module environment. ! 


current is the existing current program operated on if j 
progran the filename parameter is omitted in a | 
single-module environment. . j 


Functional Details: . | 


When the COMPLINK command is entered in a multi-module the EDF ! 
are date checked, then compiled and linked together. { 
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3724 EDIT Command 


Single-and Multi-Module Foraat: 


[voin:] filenane 
EDIT Me pudssuee eeseunaa ates 2 
current: program 


Parameters: 


voln: is a  1- to 
specifying the 
resides. If 
default is the 


filename is a  - to 
specifying the 


we 


The EDIT command enters the user into edit mode. 


4-character alphanumeric nane 
volume on which the source file 
volns is not specified, the 
default user volume. 


8-character elphanumeric nase 
current programe 


current is the existing current program operated on if 
program the filename parameter is omitted in a single- 
, or multi-module environment. 


Single-Module Functional Details: 


Use the appropriate language command (see Section 3.2) to enter 
the single-module environment with language-dependent information 


invoked. 


When a filename is specified, the appropriate volume is searched 


and if the source file is found, 
If the source file is not found: 


41- A source file is allocated. 


2. This message is displayed: 


*e* NEW PROGRAM 


it becomes the current prograa. 


3. The newly allocated source file becomes the current prograa. 


3-12 
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4%. The editor is entered with the newly created source file 
ready to be used. 


When a filenane is net specified, the user enters the editor with 
the file corresponding to the current program in the edit buffer. 
If there is no existing current program, a source file is 


allocated as previously described. 


ane EE oe meee. 


Multi-Module Functional Details: 


When a filename is specified, the system searches the appropriate 
volume for the EDF. The EDF is then searched for the specified 
filename. If the filename is not found in the aoe the command 
aborts and the following message is displayed: 


w** FPILENANE NOT IN ENVIRONMENT 


If the filename is found, the appropriate volume is searched for 
the source file. If the source file is found, it becomes the 


‘current program. If the source file is not found, an empty file 


with the specified filename is allocated, and the editor is 
entered with the empty file as the current progran. 


When a filename is’ not specified, the user enters the editor with 
the existing current program residing in the edit buffer. If a 


current program does not exist, the following message is 
displayed: 


*** CURRENT PROGRAM NOT SPECIFIED 
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3.7e5 ENVIRONMENT Command 
The -ENVISONMENT command enters a user into a aulti-module 


environnent with the specified filename as the filename of the 
EDF. 


Multi-Module Formats ‘ 


ENVIRONMENT 
[voin:] filename 
ENY 
Parameters: 

voln: is a i- to 4-character alphanumeric name 
specifying the volume on which the EDF does or. 
will reside. If the voin:s is onitted, the 
default is the default user volume. 

filename ‘is a ‘i= to S-character alphanumeric nane 


specifying the environment descriptor file, 
filename.EDF. The extension EDF is 
automatically appended. : 


Functional Details: 


The specified filename is the EDF. If filename. EDF does not 
exist, a new, empty file is allocated and the following message 
is displayed: 


eet NEW EDF 
Files can be added and removed from the EDF by using the ADD and 
REMOVE commands. = 
If a filename is not specified, the following message is 


displayed: 


aes SYNTAX ERROR 
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307-6 EXECUTE Command 
The EXECUTE command date checks source, object, and image files 
of the current program and then compiles or links them if 


hecessarye Once there is a current task image file, it is loaded 
anc run. 


Single-Module Format: 


: [voin:] filename 
EXECUTE 
iuckent program )J| [-start parameters] 


Multi-Module Formats 


EXECUTE start parameters 


Parameters: 
voln: is a t- to 4-character alphanumeric nane 
specifying the volume on which the source file 
resides. If this parameter is onitted, the 
default is the default user volume. 
filename is a  1i- to 8-character alphanumeric nare. 
specifying the current task. Specification of 
a filename is only meaningful in a 
single-module environment. 
start are parameters particular to the conpiler, 
parameters assembler, or link editor being used. These 
Parameters are usually specified in the START 
command for particular tasks. 
current is the existing current program operated on if 
progran a filename is not specified in a single-module 
environmente 
&8-043 ROO 5/81 3-15 


} Functional Details: 


{ When the EXECUTE command is entered in a  multi-module 
{ environment, all files whose filenames are listed in the EDF are 
{ compiled and linked if necessary. The task is then loaded and 
{ rune 


If start parameters are specified in a single-module environment, 
they are invoked every time the task is run until a different 
task becomes the current task. If specified in a multi-module 
environnent, the start parameters are invoked every time the task 
is run until the EDF is changed or the user enters a 
Single-module environment. 


ey 
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367-7 LINK Command > ° . | 


The LINK command date checks source and object files and then 1 
compiles then if necessary. Object files are then linked to { 


yield the task image file. { 
Single-Module Format: | . | | 
[volni] filename | { 
current. pbrogran: | [ 
Hulti-Module Fornat: | | | | | 
LINK | ; | | l 
Paraneters: 7 * | 
voln: ¢ is a = to 4-character alphanumeric name 


| 
specifying the volume on which the source file | 
resides. If this parameter is omitted, the { 
default is the default user volume. ! 


filename is a 1- to 8-character alphanumeric name | 
specifying the current programe Specifying a | 
filename is meaningful only in a single-module { 
environment. | 


current is the existing current program operated on if | 
program a filename is not specified in a single-aodule { 
environment. { 

Functional Details: | | 


When the LINK command is entered in a amulti-module environment, 
all files whose filenames are listed in the EDF are compiled and 
then linked to yield the task image file. 
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3-7-8 LIST Command 


The LIST command lists ell filenames in the current EDF. 
Single-Nodule Format: . ws 

LIST 
Functional Details: 
When the LIST command is entered, the listing 1S sent to the list 
device specified by @SYSLIST when lu assignments were made. 
If the LIST command is entered and there are no filenames 


contained in the EDF, the following message is displayed: 


wee ENVIRONMENT EMPTY 


% 
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367-9 REMOVE Contiand | 


The REMOVE command deletes a specified filename from the current | 


EDF. » | 
Single-Module Formats: | * ; { 
REMOVE fa | | | 
Parameters: | | 
£d is the file descriptor of the filename to be | 
removed from the multi-module environment. | 

Functional Details: a: | m ! 


When the REMOVE command is entered, the current EDF is searched 
for the specified fd. If the £d is not found, the following 
message is displayed: , 


oem een Om 


#** FILENAME NOT IN ENVIRONMENT | l 


If the specified fd is found, the filename is deleted from the | 
current EDF, and the file is deleted from the volume on which it i 
resides. 

If fd is omitted, the following message is displayed: j 


*** SYNTAX ERROR , : 
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10 RUN Command 


The KUN command loads and runs the specified task image file. 


Single-Hodule Formats: 


[voln:] filenan 
rol 


é 
gk dmaga” sal {start parameters] 


Multi-Module Formats: 


Para 


3-20 


fd 


RUK . 
K ask image. eat {,-start parameters] 


neters: 


volin: 


filename 


fd 


start 
Parameters 


task image 
file 


is a  1- to 4echaracter alphanumeric nane 
specifying the volume on which the task image 
file resides. If this parameter is omitted, 
the default is the default user volume. 


is a i- to 8-character name specifying the 
task image file. 


is the file descriptor of the current task. 


are parameters particular to ne assembler, 
compiler, or link editor being sed. These 
parameters are usually Eee in he START 
command for particular tasks. 


is the task image file corresponding to the 
existing current programe This file is loaded 
and run if no filename parameter is specified 
in a single- or mnulti-nodule environment. 
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Example: 
Development in a single-module environnent: H 


* FORT Specify FORTRAN environment. 
* SSETOSYSIN=CON: Set pseudo devices. 

* SSETASYSOUT=CON; 

*® SSETOSYSFRI=CONs: ; 

® EXEC TEST Find TEST.FTN and coapile. 

- FORTRANSTES : 

*#@#¢ COMPILE ERRORS, LISTING IN SYSPRT Compilation errors 


* EDIT : i 
- EDIT: TEST Find end correct errors. { 
. { 
« (CFEdit sequence) . ] 
. . | 
* EXEC Attempt to execute. ] 
- FORTRAN:TEST Compile. 

~ LINK: TEST Linkedit. 

~ TEST EXECUTION FOLLOWS Run 


(Execution sequence) 


~ EXD OF TASK CODE=0 
* EXEC Run again and ensure progras is 
compiled and linked. 


- TEST EXECUTION FOLLOWS Coupile, link unnecessary. Object t 

« (Execution sequence) and task up-to-date. | 

. { 

. t 
% 

* RON 

- TEST EXECUTION FOLLOWS No compile or link - run only. 


(Execution sequence) 


- END OF TASK CODE=0 
* EXEC NEWPROG Execute REWPROG. 


ee FILE NEWPROG. FIN NOT FOUND System finds NEWPROG.MAC (macro 

source file} not NEWPROG.FTX. 
Bust enter macro environment to 
execute. 


48-043 ROO 5/81 | | | 3-21 


on ‘ e ‘s e . Re OER RENE EE ER SO SS SA OF «LE NT SES TE OS SENG IS A EAM ge SIRI 8 Nery rar “7 


MACRO 

EXEC NEWPROG 

MACRO: NEWPROG 

CAL: NEWPROC 

LINX sR EWPROG 

NEWPEOG EXECUTION FCLLOWS 
(Execution sequence) 


ert e¢ we ege 


END OF TASK CODE=0 
EDIT 


SB teee 


EDIT: NEWPROG 


CEdit sequence) 


EXEC 

MACRO: NEWPROG 

CAL: NEWPROG 

LINK: NEWPROG 

~NEWPROG EXECUTION FOLLOWS 
(Execution sequence) 


et 6 @ @e «6 @ 


END OF TASK CODE=0 


Exanple: 


Development in a nulti-module environnent: 


% 


* ENV BIGTASK 
eee NEW EDF 

* ADD FOOSUB.CAL 
* ADD MACRTY.CAL 
* ADD FIOR.FTN 

* LISt 


FOOSUB.CAL 
KACRTY-CAL 
FTOR. FIN 

ADD SUBFUNC.FIN 
ADD YSUB.MAC 


ee 0 6 


3°22 


Specify macro environnsent. 
Execute NEWPROG.MAC 
Expand. 

Asseable. 

Linkedit. 


Hake changes to NEWPROG (source file). 


Execute KEWPROG.MAC after changes. 
Expand 

Asseable 

Linkedit 


BIGTASK.EDF is EDF. 
File is allocated, since it did not exist. 
Add 3 source nodule nanes to EDF. 


List all sodules in aulti-sodule 
environment. 
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REMOVE FOOSUB.CAL 
EDIT | 
EDITSsSUSFURC.FIN 
(Edit sequence) 


EDIT 
EDIT: YSUB.MAC 
(Edit sequence) 


EXEC 

FORTRANSFTOR.FTN 

FORTRAN: SUBFUNC.FTN 
BACRO: YSUB.MAC 

CAL: YSUB 

CAL: MACRTY.CAL 

LINK: BIGTASK 

BIGTASK EXECUTION FOLLOWS 
(Execution sequence) 


END OF TASK CODE=0 


EDIT 
EDIT: YSUB.MAC 
CEdit sequence) 


EXEC 


KACRO: YSUB.MAC 


CAL: YSUB.MAC 

LIKK sBIGTASK ve 

BIGTASK EXECUTION FOLLOWS 
(Execution successful) 


END OF TASK CODE=0 
EDIT 

EDIT sSUBFUNC.FIN 
CEdit sequence) 


COMPILE 
FORTRAN: SOUBFUNC.FTN 
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Make changes to SUBFUNC. FIN 


Make changes to YSUB.MAC. 


SUBFUNC.FITN and YSUB.MAC 


object files are outdated. 


* 


Execution errors traced to YSUB.KAC 


Correct errors in YSUB.MAC. 
SUBFUNC.FIWN not cogpiled - object 


file is up to date. 


YSUB.MAC object file is outdated. Expand, 
asseable, andi linkedit. 


Current program set to SUBFUKC.FTN. 
Bake changes to SUBFUNC.FTN. 


Compile SUBFUNC.FTR 
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CHAPTER 4 
MULTI-~TERMIWHAL MONITOR (CMNTM) BATCH PROCESSING 


4.1 INTRODUCTION 


In addition to interactive processing capabilities, MTM also 
provides facilities to support concurrent batch processing. MT 
allows the user to run multiple batch jobs from a single batch 
Queuce This feature enables the user to effectively utilize the 
capabilities of the system with minimal interference to the 
interactive users. 


The number of concurrent batch Jobs allowed at any time under MTM 
is set by the operator from the system console. This number 
cannot exceed 64. If more batch jobs are submitted than there 
are active jokstreans, MTM queues the requests until a jobstrean 
beconies available. . . 


The batch queue is an indexed file containing the file descriptor 


(fd) of the jobs to be processed. Each job is identified in the 


queue by the fd of the command file. There is no priority 
associated with a job in the batch queue. Jobs are processed on 
a first in, first out hasis. 


Tasks executing in the betch environment run at a priority lower 
than or eqttal to the tasks in the terminal environment. Thus, a 
batch job executes when the system is not occupied with work fron 
a terminal user. Batch jobs use the processor's idle time and 
therefore increase the efficiency of the systen. 


4.2 BATCH COMMANDS 
The batch job consists of a series of operator commands and/or 


command substitution system (CSS) routines. The commands 
presented in this section are unique to the batch environment. 
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M.e2e1 INQUIRE Comnand 


The INQUIRE comnand 
qQuUecUC. 


Format: 


INgurrRE [fa] [, 
Paraneters? 


fd 


fd, 


Functional Details: 


queries the status of a job on the batch 


fay]. 


identifies the job for which the status is 
desired. If fd is not specified, all jobs 
with account numbers the sane as the user's 
are displayed. 


specifies the file or device to which the 
display is output. If this parameter is 
omitted, the display is output to the 
terninal. 


fhis conmand can be entered in command mode, task loaded mode, 


and task executing 


Possible responses 


Node e 


to the INQUIRE command are: 


JOB fd NOT FOUND 


JOB fd EXECUTING 


JOB fd WAITIN 


G BEHIND=n 


NO JOBS WITH YOUR ACCCUNT 
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Exampless 


Alj jobs 


INQ 
nunber are 


INOULRE TASK.JOB The status 


FD-~ERR Invalid 


FORM-ERR Command syntax error 
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with the account 


displayed. 


user 


of TASK.JOB is displayed. 


file descriptor entered 


exists 


we ee ete amen OO cee 
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am 


be2e2 


The user 


by 


ep am es um oo om 


including 


batch strean. 


Formats: 


Functional Details: 


LOG | fa 


Parameters: 


fa 


COPY 


NOcory 


LOG Command 


can invoke 
the 


Nocopy E a) 
Copy. JEU ss 


a batch job to produce a log of its commands 
LOG command and the SCOPY command within the 


is the file descriptor of the log file or 
device. If no fd is specified, logging is 
terminated. If fd is a file, it must be 
previously allocated. Files are assigned EWO 
privileges so that logged output is added to 
the end of the filee If a log is active when 
a second LOG command is entered, the old log 
is closed and the new one is initiated. 


specifies that all output is written to both 
the terminal and the log device. 


specifies that all output, except messages, is 
woitten to the log device and not the 
terminal. Messages from other usSers and the 
operator are written to both the terminal and 
the log device. 


is a decimal number from © through 65,535 
specifying the number of lines after which the 
log file is to be checkpointed. If this 
parameter is omitted, the default is 15 lines. 
If n is specified as 0, no checkpointing 
occurs. . 


Checkpointing is only meaningful for indexed files on disc. 


Example: 


LOG PR: 


48-043 ROO 5/81 


—_ os we er a 6 a oe ow 


ue2e3 PURGE Connmane 


The PURGE command purges a submitted job. 
Format: 


PURGE fd 


Parameter: 
fd is the file descriptor of the job to be 
purged. Only jobs with the user account 
number can be purged. 
Exanples: 
PURGE TASK.JOB | TASK-JOB is purged. 


FD~ERR Invalid file descriptor entered 
FORM-ERR Command syntax error exists 


JOB NOT FOUND 
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e224 SIGNOFF Command 


The last command in a batch stream must be the SIGNOFF command. 
Formats: 
SIGHOPF 


Functional Details: 


When a terininal user signs off the system, these messages are 
displayed: 


ELAPSED TINF=hhimmsss CPUTIMNE=utine/ostime 
SIGNKON LEFT=hh:mmsss CPU LEFT=hh:mazss 
TINE OFF=mn/dd/yy hhsmmess 


The SIGNOFF command may be entered in cemmand mode, task loaded 
mode, and task executing modee 


Message: 


MNEM-ERR Incorrect command name 
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4e2.5 SIGNON Command 


STGKON must be the first comitand in a batch job. 


Forrat: 


fd 
| SIGNON userid [,actno, password] /EALTRONAENT=} 


[-CPu 


NULL [3] 


TIME=naxtime] 


[,}classid=iocount, [,...,classid=iocount32]}] 


Parameters: 
userid 


actno 


password 


ENVIRONMENT= 
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is a 1i- to 8-character alphanumeric string 
specifying terminal user identification. 


is a 3-digit decimal number from 1 through 250 
Specifying the terminal user's account nuaber. 
If this parameter is omitted, the password 
parameter should also be omitted. MT“ will 
use the account number of the user submitting 
the batch job. 


-is a 1i-~ to 12-character alphanumeric string 


specifying the terminal user's password. This 
parameter should be omitted if the actno 
parameter is omitted. MIM will use the 
password oc the user submitting the job. 


fd is the file descriptor specifying the file 
that will establish the user's environment at 
Signon time. 


NULL srecifies that the signon CSS procedure, 
USERINIT.CSS, should be ignored and the user 
will establish the environment at Signon time. 
If the entire keyword parameter is omitted, 
MIM searches all online dises for the signon 
CSS) procedure, USERINIT.CSS/P. The systen 
volume, system account, is searched last. If 
USERINIT.CSS is found, MTM calls the CSS and 
executes the routine. If it is not found, MIM 
enters command mode. 


CPUTIAE= maxtime is a decimal number specifying the 
maximum CPJ tine to which the batch gob is 
limited. If tnis parameter is omitted, thea 
default established at sysgen is used. If 0 
iS Specified, no limits are applied. The 
parameter can be specified as: 


nmanm?sss 
hhhhinamess 
Ssss 


classid= is one of the Kecharacter alphanumeric 
mnemonics, specified at sysgen, associated 
with each specified device or file class. 


‘jocount is a decimal number specifying the 
maximum number of I/0 transfers associated 
with a particular device class to which the 
batch job is limited. If this parameter is 
omitted, the default established at sysgen is 
used. J£ OF js specified, no limits are 
applied to that class. 


Functional Details: 


Between the SIGNON and SIGNOFF commands, any command or CSS call 
that is valid from the terminal is allowed. A SIGNON command 
cannot be followed by another command, on the same Line, 
separated by semicolons. When ENVIRONMENT=NULL is specified, th: 
colon is optional. This allows the user the ability to specify 
the null device (NULL:). 

The account number and password can be omitted if a batch job is 
submitted from a user terminal. If a batch job is submitted fron 
the system console or via the Spooler, the account number and 
password must be specified. | 


Examples: 


SIGNON ME 

S ME,12,PSWD,CPUTIME=2:30:00,DEVY1=150 
S ME,CPUTIME=120 

S ME,ENV=NULL,CPUTIMNE=129 


S ME, ENV=KYZ 
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O.27.26 SUBMIT Cournand 
The terminal user adds a job to the batch queve with the SUBMIT 
cofiwand. 
Formats 
SUB 


MIT fd (-DELETE] [,/PRIORITY=priority] 


Paraneters: 


fd is the file descriptor of the file submitted 
to batch. 
DELETE deletes the batch submit file created by the 


user to submit a batch job. If this parameter 
is omitted, the batch submit file remains on 
the user volume. 


PRIORTTY= priority is a decimal number from 1060 through 
249 specifying the priority at which a batch 
job will rune If this parameter is omitted, 
a batch job will run at the default batch 
priority (two priorities lower than the 
priority at which MTM runs) or the Link 
priority (the priority established when the 
task was built), whichever is lower. 


Functional Details: 


The priority at vhich a job will run is relative to the priority 
established at sysgen time via the SGN.PRIO option. See the 
05/32 Multi-Terrwinal Monitor (MIM) System Planning .and Operator 
Reference Manual. 


Usually when default priorities are established at sysgen time, 
interactive tasks run at one priority lower than MIM; batch jobs 
run at two priorites lower than MTM. For example: 


Assume SGN.PRIO = 14 


HTM (128) priority of MTM 
interactive jobs MIM4+1(129) one lower than MTM 
batch jobs ~ MTM4+2(130) two lower than MTM 
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Whatever prieritics are established for the above tasks at sysgen 
time ace considered IM default priorities. A ouser task 
Cu-task), which initially has a priority established when it is 
built (Link priority), can have a new priority set when it is 
submitted. If no priority is specified at submit time, the Job 
is run at the aefault pricrity or the priority established when 
the task ¥as built (Link priority), whichever is lower. The 
rules for establishing priorities are: 


® Batch jobs can be specified to run at the same priority as 
interactive tasks but not higher than interactive tasks. This 
would be considered invalid. 


® If a priority is specified, the batch job will run at that 
priority aif valid, or the Link priority, whichever is lower. 
If the priority is not valid, the following message is 
displayed, and the default priority is assigned by MIM: 


WARNING ~- REQUESTED PRIORITY nt ILLEGAL, n2 USED 


e If no priority is specified, the batch job will run at the 
default priority or the Link priority, whichever is lower. 


This command can be entered in command mode, task loaded mode, 
and task executing mode. 


Exanples 


Create a batch job stream from the terminal via the BUILD/ENDB 
seduence as follows: 


BUILD TEST.JOB 
SIGNON ME,FNV=NULL 
LOG PR: 
L TEST.TSK 
AS oP Re 
START 
SIGNOF 
ENDB 


Submit the joh from. the terminal for batch processing as follows: 


SUBMIT TEST.JOB 
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Subpit a bacch submit File and have it deleted 
Sj CPecwuts on 25° coup lote: 


SUBMIT XY2.JOB, DELETE 


Submit a batch job and have it run at the same 
interactive job: 


SUBMIT XYZ.JOB, FP=129 


Hessages: 


after the 5 


priority as 


BICH-ERR Batch capability not available 
FD-ERR Invalid file descriptor 
FORM-ERB Command syntax error 
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&.3 BATCH JOB SUBMISSION USING THE SPOCOLER 


The Spooler is alse used to submit batch jobs to the batch queve 
for execution under NTN. Batch jobs submitted through the 
Speoler can later he resubmitted as a batch jobs through the 
terminal. ; 


4.4 ERROR HANDLING 


Any error that occurs in a batch job causes automatic termination 
of the job, and a message is written to the log file or device. 
If a batch task pauses, the task is cancelled by MIM and the end 
of task code is set to 258. The job will continue at the command 
foljJowing the START; i.-G@e, the next task will be loaded. The 
task end of task code can be tested by subsequent commands in the 
batch stream to determine if the task completed normally. 


4%.5 EFFECT OF RESTRICTED DISCS ON BATCH JOBS 


When accounts having access to restricted discs are given 
read/write access, katch jobs are not affected. If read<only or 
no access is specified, messages will not be displayed on the 
user console, lf a submit file for a batch job is ona 
restricted disc and account 0 does not have read/write access, 
the following nhessage is displayed on the system console: 


eMTMSBATCH ASGN-ERR TYPE=PRIV JOB=fd 


4-12 , 48-043 ROO 5/81 


CHAPTER 5 
COMMAND SUBSTITUTION SYSTEM (CSS) 


5Se1 GENERAL DESCRIPTION 


The Connand Substitution System (CSS) is an extension to the 
OS/32 command languagee It enables the user to establish files 
of dyhnanically modifiable commands which can be called from the 
terminal or cther CSS files and executed in a predefined 
sequence. In this way, compiex operations can be carried out by 
the terminal user with only a small number of commandse CSS 
provides: 


e the ability to switch the command input stream to a file or 
device; 


e® a set of logical operators to control the precise sequenca of 
commands; 


@ parameters that can be passed to a CSS file so that general 
sequcnces can be written to take on Specific meaning when the 
Farameters are substituted: and 


e the ahility for one CSS file to call another, in the manner of 
a suhroutine, so that complex command sequences can be 
developed. 


k CSS file is simply a sequential text file. It could be a deck 
of cards, a magnetic tare, or a dise file. An exanple of a 
simpie CSS file is: 


*THIS IS A SIMPLE EXANPLE OF A CSS FILE 
LOAD TEST.TSK/G,5 

ALLOCATE XXXDIX.DTA,CO,40 

AS 1,INPUT.DTA 

AS 2,XXXDIX.DTA;3AS 5, CON: 

ASSIGN 3,PRT:;*LU3-LINEFRINTER 

START 

SEXIT 


5.2 CALLING A CSS FILE 
A CSS file is called and executed from the terminal by specifying 
the file descriptor (fd) of the CSS file. Any valid fd can be 


used. When the leading characters of an fd are the same as a 
command, then MIM assumes a command: 
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CLO.CSS CLOSE 


ASP12.C8S K 
PC12.CS5 OK 
AS3.CSS ASSIGN 3 


ASG3.CSS OK 


However, by specifying a volume name and/or extension, a CSS file 
can be called that might normally conflict with an MTM supported 
command. The following are all valid calls to a CSS file with 
the fd of CLOSE: 


-~H300: CLOSE 
-M300:CLOSE.CSS 
-~CLOSE.CSS 


If the file extension is omitted, the CSS extension is assumede 


If the file does not exist as specified, the error message 
MNEH-ERR is returned. 


Parameters are passed to a CSS file by appending them to the fd 
of the CSS file. If a parameter contains the double quote 
character (") then all characters up to the next double quote are 
passed. The double quotes themselves are not passed. The first 
parameter must be separated from the filename or device by a 
space; all other parameters must be separated by commas. Null 
parameters are permitted. Valid CSS calis are: 


RUN calls CSS file RUN.CSS on the default user 
volume. . 
JUMP A,B,C, calls CSS file JUMP.CSS on the default user 


volume with three parameters A,B,C. 


JUEP 240 calls CSS file JUMP.CSS on the default user 
volume with three parameters; the first two 
are null. 


VOLN: JUMP calls CSS file JUMP.CSS on the volume YOLN. 

ABC Pi,"P2A, calls CSS file ABC.CSS on the default user 

P2B,P2C",P3 volume with three parameters. Parameter 1 is 
Pi. Parameter 2 is P2A, P2B,P2C. Parameter 
3 is P3. 


5.3 USE OF PARAKETERS 
Rithin a CSS file, a parameter is referenced by the use of the 


special symbol "dn“ where n is a decimal integer number 
indicating which parameter the user is referencing. Parameters 
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are humbered starting with 1. Parameter O hb 
and ais defined iater in this section. Hee 
referenced by 931, the second 2, etc. A Os 
substitution is employed. 


as special ASSRUAG 
a first paraneter is 
traightforward text 


Example: 
Ah CSS file ROG consists of: 


LOAD a1 
START 23,22 


It is called as follows: 
ROG PROGRAN, NOLIST,148 


Before each line of the CSS file is decoded, it is preprocessed, 
end any reference to a parameter is substituted with the 
corresponding text. Thus, the file ROG with the previous call is 
executed ass 


LOAD PROGREM 
START 148,NOLIST 


A reference to a parameter is terminated by a non-numeric 
character. 


Exanple: 


All of the following references to parameter 12 are valid 
expressions: . 


212 or @TZABC or 012.EXT 


é 


Notice that this mechanism allows concatenation. For instance, 
if the first conmand in file ROG were LOAD 01.TSKy only those 
files with the extension .TSK would be presented to the loader. 
Concatenation of numbers requires care. 12301 references 
parameter 13 but, 21123 is a reference to parameter 1123. A 
reference to a nonexistent parameter is considored to be null. 
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The multinle a facility enables a CSS file to access parameters 
of higher Jevel files. CSS files can call each other to a 
Maxivun devth stecified at sysgen time. Thus, 222 in a CSS file 
refers to the second parameter of the calling file. 


Example: 

Given the CSS call, 
eee argi-,arg2 

and assuming that in file CSS1 there is another call, 
CS82 arg3,argit 


the following references can be made in CSS2: 


a1 = arg3 
@2 = arg 
aa1 = arg? 
@a2 = axrg2 


If a muitiple @ sequence is such that the calling level referred 
to iS nonexistent, the parameter is considered to be null. 


Parameter a0 is a special parameter used to reference the name of 
the CSS file it is contained ine Parameter 090 is replaced during 
the preprocessing of the command line with precisely the same 
style descriptor used to call the file. 


Exanples 
A CSS file consists of: 


AS 1,00 
SEXIT 


If this file is called from the card reader (CR:), then lu 14 is 
assigned to the card reader (CR:). Likewise, a call from the 
magnetic tape (MAG1:) results in; 


AS 1,HAG1: 
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S5e4 USE OF VARIABLES 
ETM and patch users can allocate a specified number of variables 
to be used within a CSS. The maximum number of variables that 
can he cefined is established at sysgen time. See the 0S/32 
Multi-Terminai Nonitor (MTH) System Planning and Operator 
Reference Manual. 


5.4.1 Types of Variables 


There are two types of variables: 


@ Global variabies 

@ Local variables 

Global variables exist from signon to signoff or until they are 
freed via the SFREE commande A local variable can be used only 
within the CSS level in which it was defined. When a particular 
CS$ level is exited, all local variables defined within it are 
freed. 

5.4.2 Naming Variables 

A variable nate can consist of one through eight characters and 
is preceded by the commercial dad sign. The character following 


the @® sign must be alphabetic and the remaining can be 
alphanumeric. 


Examples: 


OA 
aB19 


AABC123 


§-4.3 Defining Variables 
All variables must be defined by name using the SGLOBAL and 


SLOCAL commands. To set a variable to a specific value, the $SET 
conmand is used. 


5.4.4 Reserved Variables 
Variable names starting with the character string a@SYS are 


reserved for system use in the program development environment. 
If a user tries to define variables starting with @SYS, a message 
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LS Gh pyved}; However, a uUSetC dees have read and ¥rite access to 
95YS veriahbles fron within a particular development environnent. 


The global variable @SYSCODE is reserved and contains the value 
of the last end of task code for a particular session. 


525 COMMANDS EXECUTABLE WITHIN A CSS FILE 


All of the MIN supported commands can be used in a CSS file, as 
well as a number of commands specifically associated with the CSS 
facility. 


All of the CSS commands start with the character $ except for the 
SET CODE command. The $ helps to indicate where a CSS has been 
used. 


The CSS commands entered within a CSS file are described in the 
following Sectionse Refer to Appendix E for CSS message 
descriptions. 


NOTE 


If a task is started when CSS is running, 
CSS becomes dormant until the task is 
terninated. Execution of the CSS stream 
will resume after the task terminates. 


+ 
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i “SBULLP and || 
{ SENDB | 


5.5.1 $BUILD and SENDB Commands 


The SBUYLLD conmand causes succeeding lines to be copied to a 
specified file, up to but excluding the corresponiing SENDB 
commend. Before each line is copied, parameter substitution is 
performed. 


Format: 
fd 
SBUILD, > [- APPEND] 
lu 
SENDB 


Parameters: 


£4 is the output filee If fd does not exist, an 
indexed file is allocated with a logical 
record Length equal to the command buffer 
length. If the fd specified does not contain 
an extension, eCSS is the default. If a blank 
extension is desired, the period following the 
filename must be specified. , 


lu specifies that a temporary file is to be 
created and the SBUILD data is copied to it. 
When SENDB is encountered, the file is 
assigned to the specified logical unit of the 
loaded task. 


APPEND | allows the user to add data to an existing fd. 
If the fd does not exist, it is allocated. 


Functional Details: 


The SBUILD command must be the last command on its input line. 
Any further information on the line is treated as a comment anc 
is not copied to the file. 


The SENDB command must be the first command in the conmand line, 
but it need not start in column 1-2 Other commands can follow 
SEXDB on the command line, but nesting of SBUILD and SENDB is not 
permitted. - . 
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: 54 562 SCLEAR Conmand 


The SCLEAR cemrand is used to terminate a 
conmand causes closing of alli CSS files and deactivation of CSS. 


Functional Details: 


The SCLEAR comnand may be entered in 
mode, and task executing node. 


command 


css streama 


This 


mode, task loaded 
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§8e52 3) )|«6SCONTIRUE Command 
The SCONTINUE cemmand resunes execution 


suspended by a SPAUSE or SWALT command. 


Formets 
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CSS procedure 
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525-4 SCOPY and SNOCOPY Conmands 


The SCOPY and SNOCOPY commands control the listing of CSS 
commands on the terminal or log device (if from batch). SCOPY 
turns on the listing and all subsequent comands are copied to 
the terminal before: being executed. The SNOCOPY cominand turns 
off the listing, but is itself listed. The SCOPY conmand is 
effective in debugging CSS job streams. 


Format: 
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Bebe) ©=©6SEXIT Conmand 
The SEXIT command is used to terminate a CSS procedure. Control 
‘is then returned to the calling CSS procedure of the terminal if 
the CSS procedure was called from the terminal. All commands on 
the same line after the CSS call are ignored. 

| 
Format: 


SEXTT 
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5.5.6 SFREE Comnand 


The SPREE commend frees one or more variables. 
Format: 

SFREE varnancy [peoe, Varnamey | 
Paraneterss; 


varnanme . is a t- to 8echaracter name specifying the 
Variable whose name and value are to be freed. 


Examples: 


SFREE OA 
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682567 SGLOBAL Command 


The SGLOPAL command names a global variable and specifies the 
length of the value to which it will be set by the SSET comnand. 


Forinat: ! 
. Length Length 
SGLOBAL varnane _ seooesVarname _ 
8. 1 & n 
Parameters: 
yreuname is a %- to 8-character name (the first 


character is alphabetic) identifying a glisbal 
variable. 


Length js a decimal number fron 4 throuch 32 
specifying the length of the variable defined 
by the S$SET command. Ii this parameter is 


omitted, the default is 8. 
Exanples: 


SGLOBAL @ACE) 
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6e5e 8B = =6SIJICB and STERMJOB Conmands 


The SJOB and STERMNJOB commands set the boundary for a CSS Joh. 
A CSS job consists of all the terminal user commands and tasks 
leaded and started betveen a SJOB and STERMJOB. The $JOB cormand 
indicates the start of a CSS job and the STERNJOB indicates the 
end of a CSS job. These conmands need not be included in a CSS 
procedure but are useful in preventing errors in one CSS job fron 
affecting subsequent CSS job processing. Most errors encountered 
in executing terminal user conmands in a CSS job cause the 
renaining statements to be skipped until a STERMJOB is 
encountered. The skips to STERMJOB occur if the error is 
detected within a CSS job. The job is aborted and the next 
conmand executed is the first command after STERMJOB.- At this 
point the end of task code is 255. If the error occurs outside 
a job, CSS is aborted. If STERMNJOB is omitted, errors can cause 
a Subsequent SJOB statement to be skipped. 


Separating CSS jobs delimited by S$JOB and S$TERMJOB' statements 
eliminates the chance of errors in one job affecting another. 


S$JOB resets the end of task code to 0. 


Formats 


Paraneterss 


CPUTIME= maxtime is a decimal number specifying the 
maximum CPU time to which the CSS routine is 
limited. If this parameter is omitted, the 
default established at HMTM sysgen is used. I£ 
O is specified, no limits are applied. 


classid= is one of the W-character alphanumeric 
mnemonics specified at MIN sysgen that is 
associated with each specified device or file 
classe 
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jocount is a decimal number specifyi 1 the 
1 


maxinum CPU tite to which the CSS routine 

Liniteade If this parameter is omittec, the 
default established at sysgen time is used. 
If 0 is specified, no limits are applisd to 


that clases. 


Interactive jobs heve no default limits established at  sysgen 
tine. However, the terminal user can specify CPU time and 1/0 


transfer limits for a particular job through the SJOB command. 


Any linits in the SJOB command found in a batch stream are 
ignored if liwits were already specified in the SIGNON command. 
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$2569 SLOCAL Connand 


The SLOCAL command names a local variable and specifies the 
length of the value to which it will be set by the SSET command. 


Format: 


length flength 
SLOCAL varname ( ,eove,Varname ( 
1 n 


Parameters: 


varname 


length 


Examples 


SLOCAL @AC4) 


8. 8. 


is a 1- to 8-character name (the first 
character is alphabetic) identifying a local 
variable. 


is a decimal number from 4 through 32 
specifying the length of the variable defined 


by the SSET command. If this parameter is 
omitted, the default is 8. 
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5e5e10 SPAUSE Conmand 


The SPAUSE command suspends execution of a CSS procedure. 

Format: 
SPAUSE 

Functional Details: 


When SPAUSE is entered, the CSS procedure remains suspended until 
the SCONTINUE command is entered or the SCLEAR command is entered 
to terminate a procedure suspended by a $SPAUSE. 
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682564741 SSET Conmand 


The $SET command establishes the value of a named variable. 
Fornats 

SSET varname=e 
Parameter: 


variable= e is an expression, variable, or parameter 
established as the value of the variable. 


Functional Details: 


Expressions for this command are concatenations of variables, 
Parameters, and character strings. No operators are allowed in 
an expression. If a character string is included in an 
expression, it must be enclosed between apostrophes ('). If an 
apostrophe is part of the character string, it must be 
represented as two apostrophes (‘'). 


The initial value of the variable is blanks. This allows the 


SIFRULL and SIFNNULL commands to be used to test for a null or 
not null value. . 


Examples: 


SStT aA @AITAA2 


SSET OA = OA1". MAC 


SSET OA a 1 


" 


il 


oReepe 


SSET a- 
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5.5.12 SET CODE Cornmand 
The SET CODE command modifies the 
currently selected CSS task. 
Forhats: 
SET CODE n 
Paraneter?: 
n is a decimal value 
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525413) 0 «6SSKIP Connand 


The SSKIP command is used between the $JOB command and STERNJOR. 
The SSKIP commend indicates that subsequent commands are to be 
skipped until a STERMJOB command is found. The end of task code 


is set to 255. 
Formats: 


SSKIP 
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5252-74 SWAIT Command 
The SWAIT command suspends execution of a CSS for ae specified 


period of time. 


Formats: 


n 
SWHAIT ; 
7. 


Paraneters: 


n is a decinal number from 1 through 900 
specifying the number of seconds CSS execution 
will be suspended. If this parameter is 


omitted, the default is 1 second. 
Functional Details: 


The SHAIT command will oniy function from a CSS routine. 


When the SWAIT conmand is entered and the user does not Want to. 


wait for the completion of the specified time, a SCONTINUE 
command cah be entered. 
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525215 SWRITE Command 


The SWRITE command writes a message to the terminal or log device 
for both interactive and batch jobs. 


Format: 
SWRITE text [+] 
Functional Details: 


The message is output to the terminal or log device. It begins 
with the first nonblank character after SWRITE and ends with a 
senijicolon cr carriage return. The semicolon is not printed. 
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5.6 LOGICAL IF COMMANDS 


The logical IF commands all start with the three characters, SIF, 
and allow one argument; eege, SIFE 225, SIFX B.CSS, SIFNULL a1. 


Each logical connand establishes a condition that is tested by 


the CSS processor. If the result of this test is true, then 
commands up to a corresponding SELSE or SENDC command ate 
executed. If the result is false, these same commands are 
skipped. 


The SENDC command delimits the range of a logical IFs however, 
nesting is permitted so each SIF must have a corresponding SENDC. 


In the following examples, the ranges of the various logical IF 
commands are indicated by brackets: 


SIF SIF SIF 

SENDC SIF SIF 
SENDC SENDC 

; SIF 

SENDC ~ 

SENDC 

SENDC 

‘"fhere is no testriction on the depth of nesting. Logical IF 


commands are used within a CSS file. However, they differ from 
previous CSS commands in that each one tests a specific built-in, 
defined condition rather than causes a specific action. 


The logical IF commands fall into three categories: 


e End of task code testing 
e File existence testing 


e Parameter existence testing 
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5.641 Ena of Task Code Testing Commands 


The end of task code is a halfword quantity maintained for each 
user by the systen. It is set or reset in any of the following 


Wayss 


SET CODE n 


SJOB 


Command error 


SSKIP 


EOT (SVC 3,n) 


CANCEL 


This command, which can be included in a CSS 
file or entered at the terminal, sets the end 
of task code to ne 


As part of its start job function, this 
command resets the end of task code for the 
current CSS task to 0. 


kh command error causes the CSS mechanism to 
skip to STERMJOB assuming that a $JOB was 
executed. (If no S$JOB was executed, CSS 
terminates. ) To indicate that the skip took 
place, the end of task code is set to 255. 


This command has the same effect aS a command 
errore 


When any task terminates by executing the FOr 
program command (SVC 3,n), the end of task 
code for that task is set to ne 


When a task is cancelled, the end of task code 
is set to 255. 


The Six commands available for testing the end of task code of 
the currently selected CSS task are as follows: 


SIFE n 
STFNE n 
SIFL n 
SIFNL n 
SIFG on 
SIFNG nn 


Test end of task code equal to n 

Test end of task code not equal to n 
Test end of task code less than n 

Test end of task code not less than n 
Test end of task code greater than n . 
Test end of task code not greater than n 


In all cases, if the results of the test are "false", CSS skips 


conmands until 


the corresponding SELSE or SENDC. If such 


skipping attempts to skip beyond EOF, a command error is given. 
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5e6e2 File Existence Testing Commands 


There ere two commands dealing with file ervistence:? 


SIFX fd Test fd for existence 

SIFNX fd Test fd for nonexistence 
If the result of the test is false, CSS skips to the 
corresponding SELSE or SENDC command. If such skipping attenpts 
to skip beyond EOF, a command error is given. 
5.6.3 Parameter Existence Testing Commands 


There are two commands dealing with the existence of parameters: 


SIFNULL an fest adn null 

SIFNNULL an fest an not null 
If the result of the test is false, CSS _ skips to the 
corresponding SELSE or SENDC command. If such skipping attempts 
to skip beyond EOF, a command error is given. 
fhe use of the multiple ad notation to test for the existence of 


higher level parameters is permitted. In addition, a combination 
of parameters can be tested simultaneously. 


Examples 
SIFNULL 0210203 


In effect, this tests the logical AND of a1, @2, and a3 fur 
nullity. If eny of the three is present, then the test result is 
false. 
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5-604 SELSE Command 


The SELSE command is used between the SIF and SENDC command to 
test the onpesite condition of that tested by SIF. Thus, if the 
condition tested by SIF is true, SELSE causes commanis to be 
skipped up ta the corresponding SENDC. If the condition is 
faise, SELSE terminates skipping and causes conmand execution to 
NESUING. 


Formats: 
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5.7 S$GOTO end SLABEL Commands 
The SGOTO command is used to skip forward within a CSS PEScecence 
The SLABEL is used to define the object of a S$GOTO. 


Formats 


sGOTO label 


if es9 


SLABEL label 
Label is from 1 to 8 alphanumeric characters, the first of which 
hust be alphahetic. 
The SGOTO command causes all subsequent commands to be ignored 
“until a SLABEFL command with the same label as the S$GOTO command 


is encountered. At that point, command execution is resuned. 


The SGOTO cannot branch into a logical IF command range but can 
branch out from one. 


An exauple of an illegal SGOTO is: 


SIF Condition 
$GOTO OUTIF 
SENDC 

SIF Condition 


SLABEL OUTIF 


The SLABEL occurs Within an IF block (the second IF condition) 
that was not active at the time of execution of the SGOTO. 
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The foliowing 


SIF 
Ecoro 


SEN DC 
SLABEL 


is valid, however: 


Condition 
OUTIF 


Condition 


OUTIF 


48-043 ROO 


5/81 


Cee ee eee ee ee ee, er ee a ee ces 


{ SIFEXTENSTON 4 
§.8 S$IFEXTENSION Command 
The SIFEXTENSION command is used to test for the existence of an 
extension fer a given fd. If the extension exists, subsequent 
commands are executed up to the corresponding SELSE or SENDC. If 


an extension does not exist, subsequent commands are skipped up 
to the corresponding SELSE or SENDC. 


Format: 
SIFEXTENSION £4 


Parameter: 


fd is the file descriptor to be tested to 
determine if an extension is included. 
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569 SIFYOLUME Command 


The SIFVOLUKE command is used to test for the existence of a 
volune iain an fd. If a volume exists, subsequent commands are 
executed up to a corresponding SELSE or SENDC. If the volume 
field was omitted in the file descriptor, subsequent commands are 
skipped up to the corresponding SELSE or SENDC. 


Format: 


SIFVOLUKE £4 


Paraneter: 
fa is the file descriptor tested to determine if 
a volume is included. 
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5e10 LOGICAL TF CONMANDS COMPARING THO ARGUMENTS 


The follovying logical JF conmands are used to compare two 


argumentse They differ from the other Logical IF commands in 
that they do not test specific built-in conditions but, rather, 


test conditions pwrovided by the user. These commands are 
available only with MT. . 


SIF .« 6 © «© « EQUAL 
SIF 2. « « » © NEQUAL 
SIF . © »« « « GREATER 
SIF 2. « © e« « NGREATER 
SIF « « e « « LESS 

STF © « « e e« NLESS 


For each of the logical commands, two argumentS are compared 
according to the mode. There are three valid modes: 


e Character 
e Decimal 


e Hexadecinal 


For character modc, the canmparison is jleft-to-~right and is 
texnineated on the first pair of characters that are not the same. 
If one string is exhausted before the other, the short string is 
less than the long strings If both strings are exhausted at the 
Same time, they are equal. For character mode, the arguments can 
be enclosed in double quotes if they contain blanks. The quotes 
are not included in the ccmpare. 


For decimal and hexadecinal mode, the comparison is performed by 
comparing the binary value of the number. 


If after comparing the arguments for each of the comnands, the 
condition is determined to he true, subsequent commands are 
executed up to the corresponding SELSE and SENDNC. If the 
condition is false, commands are skipped up to the corresponding 
SELSE or SENDC. 
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Se1061 SIF... EQUAL, SIF.LeoHNEQUAL Commands 
The SIF..e-EQUAL command is used to determine if two arguments are 


equai while the SiF..e-NEQUAL is used to determine if two 
arguments are not equale 


Formats: 


CHARACTER 
SIF DECIMAL arg, FQUAL arg 


HEXADECIMAL . 


CHARKCTER 
SIF DECIMAL arg, NEQUAL arg2 


HEXADECIMAL, 
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5.1002 SIF.s-GREATER, SIF.essNGRFEATER Commands 


The SiFeeeGRUOATER command is used te determine if arg; is greater 
than arg2. The SIF..«-NGREATER command is used to determine if 
arg, is not greater than arg 2. 


Format: 
CHARACTER 
SIF DECIMAL alg, GREATER arg2 
HEXADECIMAL 
CHARACTER | 
SIF DECIMAL arg, NGREATER argg 
HEXADECIMAL 


5.1063 SIF...LESS, SIF..e-NLESS Commands 


The SIF..-LESS command is used to determine if arg, is less than 
argae The SIF.e.e-NLESS command is used to determine if arg, is 
not less than argo. 


Format: 
/ CHARACTER 
SIF DECIMAL arg, LESS arg2 
HEXADECIMAL 
CHARACTER 
SIF DECINAL arg, NLESS arg 2 


HEXADECIMAL 
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CHAPTER 6 
SPOOLING 


bel INTRODUCTION 

The OS/32 package comes with a spooler task for both input and 
output spooling. At system generation (sysgen) time, the spool 
option must be included and the pseudo print devices declared, in 
order to incorporate the spooling facility. 


6.2 INPUT SPCOLING 


The input spooling feature provides for copying a batch Stream of 


cards such as source programs, operator command, command 
substitution system (CSS) files, or other user data onto a disc 
file for immediate or subsequent processing. There are twa 


control commands available for input spooling: 


/OINPUT 
/OSUBMIT 


In all cases, each deck of cards to be copied must end with a 
control card with the /d appearing in columns 1 and 2. 


6.2.1 Input Card 


The /GINPUT card copies all the data between the /@INPUT and the 
/ad cards to a disc file. The resulting file can be explicitly 
assigned and read by the user in order to access the spooled 
information. 


Cards to be copied must be preceded by a control card with the 
formats: 


Z@INPUT fd/actno [, DELETE] 


Parameters: 


fd is the file descriptor of the disc file in the 
form of voln:filename.exte The only required 
field is filename. If voln is omitted, the 
default spool volume is used. 
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actno js the account number the terminal user signs 
on With. 


DELETE specifies that if a file with the same name 
and account number already exists, that file 
is deleted and reallocated. 


NOTE 


Tf the wrong account number is entered, 
the user might delete another user file. 


Examples 


Ah certain task (TEST.TSK) requires five input data records in 
order to execute. The following statements place these five 
input statements ona disc file named TEST.DTA (associated with 
account number 12). 


It deletes and reallocates TEST.DTA if it already exists. 


/@IN TEST.DTA/12,D 
G INPUT TEST 
122735 

545627 

889710 

632192 

/a 


662-2 Submit Card - Adding Batch Jobs to the Batch Queue 

The Spooler can also be used to submit batch jobs to the 
multi-terminal monitor (MTM). This is done through the /adaSUBMIT 
cominand which copies card files to the disc and submits the file 
as a batch jobe The commands are executed in sequence. The file 
remains on the disc after execution is complete. 

To add batch jobs to the batch queue via the Spooler, submit a 
control card with the format: , 


Format: 


ZOSUBMIT fd/actno [,DELETE] 
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Parameterss 


fd is the name of the command file; i.e., the 
batch job, that is to he placed on the batch 
queue. 

actno is the account number the terminal user signs 
on with. 


DELETE specifies that if a file with the same name 
and account number exists, that file is to be 
deleted and reallocated. 


Fach deck of cards must end with a control card with /d appearing 
on columns 1 and 2. 


Refer to the 0S/32 System Support Utilities Reference Manual for 
more information on the Spooler. 


Examples 


There are two methods for submitting a batch job using the 
Spooler. 


Method 13 


First a CSS file is copied from a card file to a disc file named 
TEST.CSS (associated with account number 12) on the default spool 
volume. If TEST.CSS already exists, it is deleted and 
reallocated. This is done as follows: 


/AINPUT TEST.CSS/12,D 
LO TEST | 

AS 1,TEST.DTA 

AS 3,PR: 

AS 5,NAG1: 

START 

/a 


The CSS file TEST.CSS now can be executed by the batch job 
TEST.JOB. If a file already exists on the disc with the name 
TEST.JOB, it is deleted and reallocated. When running concurrent 
batch jobs, each signon id must be unique. Submit this job as 
follows: 


/O@SUBMIT TEST.JOB/12,D 
SIGNON ME,12,PASSWD 
LOG PR: 

TEST.CSS 

SIGNOFF 

/a 
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Method ?: 


Oniy one Step is required to build the file TEST.JOB and submit 
it as ae batch joh. The conmanis are executed in sequence. If 
the file TEST.JOB already exists on the disc, it is deleted and 
reallocated. After this batch jeb completes, the file TEST.J08B 
remains on the disc: 


/ASUBMIT TEST.JOB/12,D 
SIGNON NE,12,PASSWD 
LOG PR: 

LO TEST 

AS 1,TEST. DTA 

AS 3,PR: 

hS 5,MAG1: 

SLART - 

SIGNOFF 

Ja 


6-3 OUTPUT SPOOLING 


Output spooling allows more than one task to be assigned to one 
or more print or punch device simultaneously. Data to be printed 
or punched is written to disc files where it is then copied by 
the Spooler to the available print or punch .devices on ae task 
priority basis. 


To make use of the output Spooler, assign any logical units (lw) 
to be printed or punched to one:or more pseudo devices. As soon 
as the lu is closed, the Spooler automatically will print or 
punch the results. Printing or punching may be delayed because 
of a backlog to the device. 


There is no limit to the number of tasks or logical units that 
can be assigned to a pseudo device. After the user makes an lu 
assignment, the following occurs internally. The operating 
System automatically intercepts all assignments to a pseudo 
device and allocates an indexed file called a spool file on the 
spool volvuine. Subsequent output calls cause data to be written 
to this file and not to the device. The Spooler supports both 
image and formatted writes. 


When the lu assigned to the spool file is closed, the filename, 
task mame, and priority are placed into the Spooler print or 
punch queue. The queve is maintained as a file on the spool 
volume. If there is an entry on the queue, the output spooler 
begins printing or punching and staysS active as long as there is 
something on the queue. Files are spooled and output on a task 
priority basis. 
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The user must ensure that sufficient disc space is available to 
acconnodate output spooling. The user task (u-task) is 
responsible for handling end of medium (EOM) status while writing 
to spool files within their own standard I/0 error recovery 
routines. 


Printing multiple copies of a disc file or punching multiple 
copies of a card deck is accomplished through use of the Spooler. 
To print or punch a disc file using the Spooler, issue a conmand 
through MIM from the tearminal.e. This is done with the PRINT and 
PUNCH commands (see Sections 2.35 and 2437). 


If the device specified in a PRINT or PUNCH command does not 
support printed output or output punching respectively, the 
output will he generated in the way that is supported on the 
specified device. 


For print files, a header page precedes each file printed. The 


header page has the format: 


USERID 

ACCOUNT NUMBER 

TIME OF DAY 

DATE | 
When a file is directed to a card punch file, each output record 
is 80 bytes in length. A header card precedes the punched 


outnrut: a trailer card terminates the punched output. Header 
suppression is not supplied. 


Examples 


To list and punch a file named TEST.CSS in account number 12 = xon 
the volume MIM using the Spooler, enter: 


SIGNON HE,12,MEPASS 
PRINT MTM:TEST.CSS 
PUNCH MTM:TEST.CSS 
SIGNOFF 


The header page for the print examples reads as: 


TEST 

AC=00012 
14:36:50 
07/08/77 
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6.4 SPOOLING ERRORS 
The following message is generated by the operating system in 
response to a Spooler requests: 


FILE voln:filename.ext/acct NOT ENTERED ONTO PRINT QUEUE 


A spool file was closed but the spooler task was not loaded or 
started. The file can be printed from the system console by 
entering a «SPL PRINT command whenever the Spooler is started. 
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APPENDIX A 
MULTI-TERNINAL MONITOR CMTH) COMMAND SUMMARY 


keys 
coNtreuoUS,tsize |) | 
.G000. 


ALLOCATE fd, 


Lecco} 


ofS) SU) cee 


access fLfrivileges 


RH keys 
ASSIGN lu,fdl, | tn ] ,<SVCF 


BFILE [£4,] lu 


address 
BIAS 


*. 


BREAK 


BRECORD [£a,] lu 
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fd 
BUILD [- APPEND] 


lu satan | | 


ALL 


CONTINUE [address] 


DELETE fd4[,fd2r-++-fda] 


DISPLAY DEVICES He 


DISPLAY LFLOAT 


oe Goin: 
DISPLAY Le oe Gr an ee ee 
default. ge 


fd 
DISPLAY FLOAT “ 
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fd 7 
PISPLAY LU |, 
vser consere,s | 


DISPLAY 


LISPLAY 


DISPLAY 
DISPLAY 
( MESSAGE | | a , 
PROMPT , 
ENABLE | 
ETH ' 
SVARIABLE ) 
en 
fd 
EXAMINE address! //addresgs) Z| 
FFILE [#4,] lu 
FRECORD [fd,] lu 
(mnemonic | ' 
HELP | | 
Lo ! 
segsize increment 
INIT fd], ‘ 
ch 
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inquire [fa] [,£4,] 


LOAD [taskid,]fd[,segsize increment] 


[ee foeeD| Ebel] 


userid 


message 


MESSAGE 
a OPERATOR 


BOUIFY sasress,|{ se \) Geatear.oesdetead 
° Eee 


AEPAUSE SVCPAUSE 7 
QPTIONS ’ (NONRESIDENT 
AFCONTINUE)] { (SYCCONTINUE 


PAUSE 


HESSAGE 
PROMPT 
ELM 
SVARIABLE 


PREVENT 


PRINT fd[,DEVICE=pseudo device] [,coprES=n] [, DELETE] [, VFC] 


PUNCH fd [, DEYICE=pseudo device } [,COPIES=n] [DELETE] [, VFC] 


PURGE fd 


RENAME oldfd,newfd 


REPROTECT fd,new keys 
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or 


RW [£a,] iv 


RW 
ALLI/, 
BO 
RW RW 
ctno,{/ eeereactno / 
RYOLUME voln, ee Vege fh PL 7° Uo: 
ene i ce | 
RW 
ALL JA 
BOQ. 
actno 
USERS e dactnoy, ~ actnog 


SEND me suice fs] 


SLGNOERF 


fd 
SIGNON userid [sctne, nesvord) narsnonnate| 
(NUL 


L () 


(- CPUTINE=maxtine] 


[classid=iocount, [,..-,classid=iocount 32}) 


SUBMIT fa[,DELETE] [,PRIORITY=priority] 


address | 
START ee ee [,parameter,,...,parametery |] 


taskid 
TASK 
«BGROUND 
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CONTIGUOUS, £fsize 


LTEMPFILE lu, INDEX|, { 
: S26 


VOLUME [voln] 


HWEILE [fa,] lu 


CONTIGUCUS, fsize 


XALLOCATE fd, 


XDELETE £4, [p£4. pee0,fdal | 
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APPENDIX B 
PROGRAM DEVELOPMENT COMMAND SUMMARY 


ADD fda [,cssprod] 
cat [[voin] filenane| 
COBOL [[voln:] filenane| 


[voins:] filename 
COMPILE 


current program. 


[voln:] filename 


COMPILE ALL 


[voin:] filename 
EDL T : a a. aces sites sui Din. patyeartbietnatislncasd cs Sore 
current prograa 


ENVIRONNENT . 
[voin:] filename 
ENV 


eee |; [voin: filename] 


(current program’ i [,start paraneters] 


EXECUTE start parameters 
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“rorT [[voln]] fitenane] 
FORTO [ (voany] filenane| 
[voln:] filename 
al 
( current program ; 
LINK 
LIST 
MACRO [[voln:] filenane] 


REMOVE £4 


RPG [[voin :] filenane| 


(task: ‘tnage: want start parameters] 


( [voln:] filename 
RUN 


At 


RU 
_— £206 J \ (,start parameters] 
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APPENDIX C 


MULTI-TERMINAL MONITOR (MTM) COMMAND SUBSITITUTION 
SYSTEM (CSS) COMMAND SUMMARY 


£d} 


surio| [- APPEND] 


lu 


SEXIT 


\ 


SFREE varname, [p+ se,Varnanen] 


length length 
SGLOBAL varname ( oh _ |peoe,Varname 
4 ry 


$GOTO label 


SLABEL label 
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CHARACTER ) 


SIF DECIMAL arg, EQUAL arg, 


; EXADECIMAL 
ARACTER 
DECIMAL arg, NEQUAL argg 


HEXADECIMAL 


CHARACTER 


DECIMAL acg, GREATER arg 


HEXADECIMAL 


( HARACTER 
my, DECIMAL 
HEXADECIMAL 


CHARACTER 


arg, NGREATER argg 


et i A a ee ON ae ON 


SIF DECIMAL arg, LESS argo 


HEXADECIMAL 


CHARACTER 


SIF DECIMAL arg; NLESS arg2 


HEXADECIMAL 
SIFE n 
SIFEXTENSION fd 


SIFG n 
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SIFL on 

SIFNE n 
SIFNG n 
SIFNL n 
SIFNULL aon 
SIFNNULL on 
SIFVOLUNE fd 
SIFX fd 
SIFNX fd 


$JOB [CPUTIME=max tine] 


Ce od 


[-classid=iocount, [,...,classid=1ocount 32]| 


STERMJIOB 


length\ length’ 
SLOCAL varname 7 yveeesVarname 


SNOCOPY 
SPAUSE 
SSET varname=e 


SSET CODE n 
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SSkIP 


| ry 
{ SWAIT | 2 
| 
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SHRITE text [3] 
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APPENDIX D 
TERMINAL USER COMMAND MESSAGE SUMMARY 


ACCT-ERR 


The account number specified is not between O and 255. 


ALLO-ERR TYPFE=NAME 
A desired filename currently exists on the specified volume. 


The block size of an indexed file exceeds limit established 
at sysgen time. 


For an indexed file, a zero logical record length or data 
block size was specifiede 


ALLO-ERR TYPE=TYPE 


The volune specified is not a direct access device. 


ALLO~ERR TYPE=VOL 


The volume name specified, or the name it defaulted to, is 
not the name of any of the discs currently online. 


ARGS-ERR 


The amount of Space petween CTOP and UTOP is insufficient for 
placement of START command arguments by the command 


processor. 
ASGN-ERR | 7 
The assign failed for reason denoted by TYPE field. I 


ASGN-ERR TYPE=BUFF 


An attempt was made to assign a file when there is 
insufficient system space available to accommodate the FCB. 
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ASGN-ERR TYPE=LU 


An attempt was mide to assign to an lu that is greater than 
the maximum lu number specified at Link time. 


ASGN-ERR TYPE=NAME 


An assignment is being directed at a nonexistent file. 


ASGN-ERR TYPE=PRIV 
A file, which is currently assigned to an lu with a given 
privilege, is assigned to another lu; e«ge, an assignment of 
ERW is directed towards a file currently assigned for SkO. 

ASGN-ERR TYPE=PROT 
The file being assigned to is unconditionally protected (read 
and/or write keys=X'FF*) or the read/write keys specified in 
the assign statement do not correspond to those associated 
with the file, and the file is conditionally protected (read 
and/or write keys not X‘00° or X'FF*). 

ASGN-ERR TYPE=SIZE 
An indexed file is being assigned and there is not enough 
room on the disc te allocate a physical block. 

ASGN-ERR TYPE=SPAC 
An assign is refused because the system Space available for 
task use was exceeded. 


KSGN-ERR TYPE=TCGD 


An attempt was made to assign a trap generating device. 


ASGN-ERR TYPE=VOL 
Volume name specified or defaulted to is not the name of any 


of the discs currently online. 


BICH-ERR 


The batch capability was not started and is not available for 
a SUBMIT command. : 
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The expanded CSS line overflowed CSS buffer size. 


CLOS-ERRE . | 


Close failed for reason denoted by TYPE field. | 


DELE-ERR TYPE=BUFF 


There is insufficient memory available in system space to | | 
delete an indexed file. 


DELE-ERR TYPE=NANE | 


File with a specified name was not found. | { 


DELE~ERR TYPE=PRIV | | 


An attempt is being made to delete a file that is currently | 
assigned. © a a ; | 


I 


DELE~ERR TYPE=PROT if 
An attempt is being made to delete a file with nonzero | 
protection keys. | 

DELE~ERR TYPE=TYPE | 
The volume name specified or defaulted to is not a direct | 
access device. | 

DELE-ERR TYPE=VOL | | 


Nonexistent file is assigned to a task. | 


DUPLICATE USERNAME | | : 


Userid is already in use. { 


FD-ERR : | 
The file descriptor is syntactically incorrect or invalid, or { 


a program on the disc: is being loaded and there is not enough { 
system space for the load operation. ‘ { 
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fad IS NOT A CCNTIGUOUS FILE 


The INIT command can only be used to initialize contiguous 
files, 


FORM~ERR 


The conmand format is invalid. 


GOTC-ERR 


A SLABEL that is terminating the range of the $GOTO is 
branching into and IF group. 


INVALID ACCOUNT 


Invalid or unrecognized account number. 


INVALID PASSWORD 


I/o- 


1 70> 


£[/0- 


I/0- 


I/0- 


Password is invalid. | 


ERR 


A device/file being accessed by MTM is returning a nonzero 
T/O status. 


ERR TYPE=DU 


The device is unavailable. 


EKR TYPE=EOH I/O-ERR TYPE=EOF 


The device reached an EOF or EOM before completing the 
operation. 


ERR TYPE=FUNC 
An invalid operation is being directed toward a device, e.g., 


attempting to write a read-only device. 


ERR TYPE=LU 


An illegal or unassigned lu. 
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T/O-ERR TYPE=PRTY 


q 
A parity ov other recoverable error has Gcocurred. 
Y/O-ERR TYPESUNPV 


An unrecoverable error occurred. 


JOBS~- ERR 


A $JOB statement was encountered following another SJOB 
statement but prior to a STERMJOB statement. 


JOB NOT FOUND 


fd of job to be purged is invalid. 


LOAD-ERR TYPE=ASGN 
Load could not be accomplished because the specified <fad> is 
already exclusively assignede 

LOAD-ERR TYPE=DU 


Attempt was made te load £rom a device that is unavailable. 


LOAD-ERR TYPE=1I/0 


An I/O error was generated during the load operation. 


LOAD-ERR TYPE=LIB 
The data in the loader information block is invalid. This 
error most frequently occurs when an attempt is made to load 
a task which has not been built with Linke 

LOAD-ERR TYPE=MEM 
A load is attempted when a large enough segment is 
unavailable. 

LOAD-ERR TYPE=HTCB 


The maximum number of tasks specified at sysgen tine has been 
exceeded. 
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LOAD-ERR TYPE=NOFP 


A task recduiring floating point support is being loaded, and 
the required floating point option is not supported in the 
system. 


LOAD~ERR TYPE=SEG 


A task requiring a task common area (TCOM) and/or a run tine 
library (RTL) is heing loaded, and the TCOM/RTL is not in the 
system and cannot be loaded. 


LOAD-ERR TYPE=FROIO 


There is an I/O error on the roll volume. 


LOAD-ERR TYPE=RVOL 


There is a roll file allocation or assignment errore 
LU-ERR 
An lu specified in an assign statement is invalid. 


LVL-ERR 


The number of sysgen CSS levels was exceeded. 


| MISSING PASSWORD 


| Password omitted. 


MHNEN-ERR 


The command entered is unrecognizable. 


NOFP-ERR 


No floating point support exists in the system. 


NOPR~ERR 


A command was entered that required more parameters’ than 
specified in the command line. 
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PAKN-ERKR 


A command was entered with invalid or missing parameters. 


PRIV-EUR 
The access privilege mnemonic is syntactically incorrect, or 
an HTM user without access privileges tried to access a 
restricted file. ‘ 
RENM-“ERK TYPE=NANE 


-The new filename already exists in the volume directory. 


RENMH-ERR TYPE=PRIV 
The file/device cannot be assigned for ERW (required = to 
perform the rename) because the £file/device is currently 
assigned to at least one lu. 
The protection keys of the file to be renamed are not 
X'0000'. 

REPR-ERR TYPE=PRIV 
The £Lie/device cannot be assigned for ERW (required to carry 


out the reprotection) because the file/device is currently 
assigned to at least ane lu. 


ROLL~ERR 
The task is currently rolled out. 
SEQ-ERR 
“AR command Was entered out of sequence. Terminate or pause 
the currently active task and re~enter the command. 
SIGNON REQUIRED | . | 
Attempt to enter a command before signon or a mistake in the | 


SIGNON command. | 


SKIP-ERR 


An attempt was made to skip beyond the end of a CSS job. 
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SPAC-ERR 


Task exceeds eStablished maximum system space usage. 


SYC6-ERR TYPE=ARGS 


There is insufficient room between UTOP and CTOP to contain 
the start option string. 


SYC6-ERR TYPE=DORM 


A command was issued to a specified task that is not dormant. 


SVC6-ERR TYPE=NNSG 


The task currently executing at the terminal could not 
receive a message trape 7 


SVC6-ERR TYPE=PRES 


The Spooler is not loaded, and a request is made that 
requires this progran. 


SVC6-ERR TYPE=QUE 


Spooler is dormeante 


TASK~-ERR 


A task-related command was entered and there is no currently 
loaded taske 


TIMNE-ERR 


A task cannot be loaded because the user's account CPU limit 
expirede 


USER~ERR 


An invalid userid was entered in a MESSAGE command. 
VOLN-ERR 


The volume specified is not online or the volume name is 
invalid. 
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APPENDIX E . 
COMMAND SUBSTITUTION SYSTEM (CSS) MESSAGE SUMMARY 


BUF F-ERR 


indicates an expanded command line exceeds the CSS buffer. 
The task skips to STERMJOB. 


FD-ERR 


indicates not enough space to build an fd, or required file 
support is not in system. The task skips to S$TERMJOB. 


FORH-ERR 


indicates a command syntax is invalid. The task skips to 
STERMJOB. 


GOTO-ERR 
indicates a SLABEL occurred inside an IF block that was not 
active at the time of the $GOTO commande The task skips to 
STERHIJOB. 

J/O-ERK 
indicates an EOF was found while skipping to SENDC, an EOF 
was found before a SENDB while building a file, or a STERNJOB 
was found while skipping to SENDC within a job. The task 
skips to STERMJOB, or EOT code is 255 and job is ended. 

JGBS-ERR | 
indicates a second $J0B was found. 

LVL-ERR 


indicates the CSS levels required exceed the number 
established at sysgen time. 


MNEM-ERR 


indicates the command entered is not recognized. The task 
skips to STERMJOB. 


PARM-ERR 


indicates a command was entered with invalid or missing 
parameterse 
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SEQ-ERR 
indicates a command was entered out of sequence. 
TASK~ERR 


indicates a task-related command was entered and there is no 
currently loaded task. The task skips to STERMJOB. 


@SYSXXX-VARIABLE ERROR, ILLEGAL NAME 
indicates that a variable was defined beginning with the 
reserved characters a@SYS or a system variable was attempted 
to be freed, 


@XXXX-VARIABLE ERROR, ALREADY EXISTS 


indicates that a local variable that Rcceba exists attempted 
to be defined. 


AXXXX-VARIABLE ERROR, EXCEEDS USER LIMIT 
indicates that the variable limit set at sysgen was exceeded. 
@XXXX-VARIABLE ERROR, DEFINITION TOO LONG 


Gnedesecs that the length of the darted: variable is greater 
than 32. 


@XXXX-VARIABLE ERROR, DOES vor EXIST 
indicates that the value of a variable that does not exist 
was attempted to he set or freed. Also, during CSS 
execution, a variable definition is required and that 
variable does not exiSte 

@XXXX-VARIABLE ERROR, DEFINITION DOES NOT EXIST 


indicates that the value of a variable was attempted to be 
set to the value of a second variable that does not existe 


aSYSCODE-VARIABLE ERROR, UNABLE TO ACCESS PAGE-FILE 
indicates that at signon time MTM was unable to access the 
variable page file. , 

VARIABLE ERROR, VARIABLE PROCESSING NOT SUPPORTED 
indicates that one of the following variable related commands 


was entered into a system that does not support variable 
processing: 
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= iSFRER 

~ S$GLOBAL 
- SLOCAL 
- SSET 


VARIABLE ERROR, VARIABLE PROCESSING DISABLED 


indicates that one of the following variable related commands 


was entered into a system iwith variable processing 
that is disabled: 


~ SFREE 

- $GLOBAL 
~- $LOCAL 
- SSET 
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APPENDIX F 
PROGRAM DEVELOPMENT COMMAND MESSAGE SUMMARY 


*** COMPILE ERRORS, LISTING IN fd ~ { 


Errors were encountered while compiling. A listing of these | 
errors is found in the specified fd. | 


*** CURRENT PROGRAM NOT SPECIFIED © { 
A filename was not specified, and no current program exists. | 
*** ENVIRONMENT EMPTY Ss | | | 


The LIST command was specified, but there were no filenames { 
in the EDF. , : 


#** FILE £4 IS ALLOCATED a 7 { 


The file specified in a language command could not be found; { 
a new file was allocated. | 


*** FILE fd NOT FOUND a 4 [ 
The source file corresponding to the specified filename could | 
not be found. This message is output in a single-module | 
environnmente 


*#** FILENAME CONFLICT: ENTRY NOT ADDED | 


An attempt was made to add a filename to the EDF, but that | 
filename was already listed in the EDF. - | 


*** FILENAME NOT IN ENVIRONMENT | ) 
The specified filename was not found in the EDF. | 
wee LANGUAGE ENVIRONMENT NOT SET o_ | 
A development command such as EDIT, COMPILE, COMPLINK, or 1. 
EXEC was entered without first invoking language-dependent 


information. 


*** NEW EDF | | [ 


The filename specified in the ENVIRONMENT command does not | 
exist. An empty file has been allocated. | | 
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| ar«* 


| ure 


| bike 


| Kk*k 


| kkk 


| eek 


| voln: 


| The following messages indicate the steps of program 


j and 


NEW PROGRAH 


The editor was entered with a nonexistent file; a new file is 


allocated. 
NON-STANDARD EXTENSION 


An attempt was made to add 
language 

specified. 
NOT IN MULTI-MODULE ENVIRONMENT 
that is 


A command only 


a filenane 
extension to the EDF without the cssprod parameter 


meaningful in a 


with a nonstandard 


multi-module 


environment was specified in a single-module environment. 


SOURCE FILE NOT FOUND 


The source file corresponding to the specified filename could 


not be found. This message is 


environment. 
SYNTAX ERROR 
A filename was not specified. 


TASK £d NOT FOUND 


output in a 


multi-module 


The specified task image file could not be founde 


filename EXECUTION FOLLOWS 


A task image file has been loaded and run. 


are displayed for user convenience: 


CAL: voln:. filenane 


COBOL: voln: filename 


EDIT: voin: filename 


FORTRAN: voln: filename 


LINKEDIT: voln: filename. 


MACRO: voln: filename 
filename 


RPG: volns: 


Ae NPP RTA rR y er  tne ee 


development 
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A 


Access privileges 
Account numbers, 

group 

private 

systen . 
Actno (account number) 
ADD command 
Addresses, 

exanining 

memory 
' ALLOCATE command 
. Arithmetic fault (AF) 
ASSIGN command 
Authorized user file (AUF) 


B 
Batch, 
commands 
error handling 
processing 
Batch commands, 
INQUIRE 
LOG 
PURGE 
SIGNOFF 
SIGNON 
SUBMIT 
Batch jobs, 
restricted discs 
BFILE command 
BIAS command 
BRECORD command 
BREAK coamand 
Break key 
BUILD and ENDB commands 
SBUILD and SENDB commands 


Cc 


CANCEL command 

CLOSE ‘conmand 

Command conventions 

Command substitution systens 

(CSS), 
building a command file 
calling a CSS file 
defined 

SCLEAR command 

COKPILE command 

COMPLINK command 

CONTINUE command 

SCONTINUE command 
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2-5 


1-11 
1-11 
1-12 
2-86 
3-9 


2-50 
2-£0 
2*2 


2-66. 


2-5 


1-3 


2-19 
2-20 
1-9 


1-6 
5-1 


$1 


5-8 
3-10 
3-11 
2-22 
5-9 


, 
q 
i 
| 
| SIF.seeGREATER, SIFees 
‘ 
1 
i 
1 


DiEc, 


SCOPY and SNOCOPY command 
Conventions, 
command 
file 
prompt 
statement syntax 
' terminal 
CSS commands, 
SBUILD and SENDB 
i SCLEAR 
| SCONTINUE 
SCCPY and SNOCCPY 
SELSE 
SEXIT 
SFREE 
SGLOBAL 
SGOTO and SLABLEL 
SIFees EQUAL, SIF... e-NECUAL 
SIFEXTENSICN 


NGREATER 
SIFeoeLESS, SIF..eNLESS 
SIFVOLUME 
$JOB and STERMJOB 
SLOCAL 
SPAUSE 
$SET 
SET CODE 
SSKIP 
SWAIT 
SWRITE 
CSs file, 
| calling 

commands executable 
| within . 
use of parameters 
Current program 


1 
t 
1 
if 
I 
| 
| 


Soa 


by D 
DELETE command 
Developing a prograns 


private 
_ vestricted 
; security and access 


| protecticn 


DISPLAY ACCCUNTING command 
DISPLAY DEVICES command 
DISPLAY DFLOAT command 
DISFLAY FILES command 
DISPLAY FLOAT command 
DISPLAY LU commana 

DISPLAY PARAMETERS command 
DISPLAY REGISTERS command 
DISPLAY TIME command 
DISPLAY USERS command 


CA Ae cia Re a Sod ia Sa Binal A a ee a ee EES PPE RES CPR ELT RPO 2 ORES te: g ype 
: * ] 


2-23 
3-2 


2-81 
2-80 


2-81 
2-24 
2-26 
2-28 
2-30 
2-34 
2-36 
2-38 
27-44 
2-46 
2-48 
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EDIT command 
SELSE command 
ENABLE command 


End of task code testing 


commands 


ENVIPONMENT command 
Environment descriptor file 


CELF) 


EXAMINE command 
EXECUTE command 
SEXIT command 


F 


FFILE command 
File conventions 
File descriptors 


File existence testing 


_ commands 
File, temporary 


Floating point registers, 
double precision 
single precisoion 


.FRECORD command 
SFREE command 


G 


$GOTO and SLAEBEL commands 


SGLOBAL comrand 


: H 


HELP command 
Help facility 

| 

I 


INIT conmand 


SIF.+«e EQUAL, SIFeee-NEQUAL 


: commands 


SIF.oeGREATER, SIF.«eNGREATER 


' commands 


SIFseeLESS, SIF«e-NLESS 


commands 


SIFEXTENSION command 


SIFVOLUME command 
INCUIRE command 


JK 


‘$JOB and $STERMJOB commands 


L 


’. Language commands 


LINK command 
LIST command 
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5-14 


' Leading a task 4-5 
Language-derendent information 3-4 
Link 3-5 
LOAD command 2-59 
SLCCAL command 5-16 
LOG command 2~61 

4-4 
Logical IF commands, 
comparing two arguments 5-31 
described ' 5-23 
Logical units, 
assigning. . 3-6 
} 
MN 
Memory 
address 2-50 
4 location 2-50 
; 2~64 
HESSAGE command 2-63 
MCCDIFY command 2-64 
Multi-module environment 3-4 


Multi-terminal monitor (MTM), 
command substitution systen 
| (css) 
| devices 
| environments 
help facility 
loading a task 
number of terminal users 
program development commands 
. gpecurity and access 


ah ad wh oh ad oh ah 
t# 6 @ eed 
AWIANA SwWA 


protection of discs 1-6 
signon CSS 4-7 
special features 1-5 
spooling 1-6 
sysgen 1S 

2-70 
terminal nodes 1-5 
transmitting messages 1-3 
user information 1-2 
NTH environnents, 
! batch 1-4 
'  4{nteractive 1-4 
MTM operation 1-1 
MTM user commands, 
| ALLOCATE | 2-2 
| ASSIGN ack 
‘ BFILE 2-10 
BIAS 2-12 
: BREAK 2-14 
:  BRECORD 2-15 
| BUILD AND ENDBUILD 2-17 
i CANCEL 2-19 
| CLCSE 2-20 
{ CONTINUE 2-22 
} DELETE 2-23 
| BYSPLAY ACCOUNTING . 2-24 
DISPLAY DEVICES 2-26 
| DISPLAY CFLOAT 2-28 
Ee DISPLAY FILES 2=30 
DISPLAY FLOAT 2-34 
DISPLAY LOU 2-36 | 
DISPLAY FARAMETERS 2-38 
DISPLAY REGISTERS 2-44 
DISPLAY TIME 2-46 
DISPLAY USERS 2-48 
ENABLE 2-49 
EXAMINE a ote 2-50 
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FFILE 2-52 | REPROTECT command 2-76 
FRECORL 2~54 | REWIND and RW command 2-78 
HELP 2-56 RUN command 3-20 
INIT 2-s7 sf RVOLUME command 2-80 
LORD 2-59 | 
t hoc 2-61 | 
ESSAG -6 ; 
— et 
i SEND command ; 2-83 
OPTICKS 06 SSET command : 5-18 
PAUSE 2-68 | SET CODE command 5-49 
eee Sion | SIGNOFF command 2-85 
_ 4-6 
se a ! SIGNON command 2-86 | 
: 4-7 
REPROTECT 2-76 | Single-module environment 3-3 
REWIND and RR ace | : Signon css 1-7 
SVOLOHE a. SSKIP command 5-20 
F Spooler, 
SIGNOFF 2-85 | batch job submission 4-42 
SIGNON 2-86 | Spooling, 
) ae aoe { errors 6-6 
| TEMPFILE 2-92 | peal aie 
| VOLUME 2-95 | START command 2-89 
| WFILE 2~96 { Statement syntax conventions 1-9 
|  XALLOCATE 2-98 | SUBMIT command 4-9 
|  XDELETE 2-100 | SYC 6 2-66 | 
| 2-83 | 
| 0 = f sve 45 ) 2-6 i 
cae | System generation (SYSGEN) 4-5 
OPTIONS command 2-66 | f. 
: 2 bps mi Se H ; 2-70 
- -1 
Parameter existence testing { | . 
commands aee | foo eee eae — 
PAUSE command 2- Task, | 
SPAUSE eactt See ' loading and running 3-7 ' 
PREVENT comman = TASK command 2-91 3 
PRINT command 2-70 [ Task Status Word (TSW) 2-83 i 
Processing, batch 4-4 { TEMPFILE command 2-92 ' 
Program development commands, . | Tewporary file 2-92 i 
functional description 3-1 Terminal conventions 1-8 ' 
generel description ae Terminal nodes, MTM 1-5 
Program development commands, | iy es ee ees 4, 
ADE 3-9 f ) u | 
CCHPILE 3-40, eee Peree | 
COMPLINK - ‘Userid 2-63 | 
EDIT : 3-12 | User information, MT 1-2 
ENVIRONMENT a~8 | User registers : 2-44 | 
EXECUTE 3-45 { User tasks (u-taeks) 4-1 
LINK 3-17 | 
REMOVE - cos a. Meet opus 
RUN 3-200 | vardabies, 
Prompt conventions 1-7 { use of: 5-« 
PUNCH command é 2-72 | =< VFC (vertical forms control) 2-6 
PURGE command 4-5, VOLUHKE command “95 
Bk i. ee, teat | 
hecieteras , | '$WAIT command 5-21 
double precision floating | | i WFILE command 2-96 
point 2-28 | SWRITE command 5-22 
Single precision floating { + : 
point 2-34 i XYZ 
user 2-44 me me Pens 
REMCYE command ~ge49 «|| XALLOCATE command 2-98 
RENABE command 2-74 { ‘XDELETE conmand 2-100 
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CHAPTER 5 
COMMAND SUBSTITUTION SYSTEM (CSS) 


Bel GENERAL DESCRIPTION 


The Connand Substitution System (CSS) is an extension to the 
OS/32 command languagee It enables the user to establish files 
of dynanically modifiable commands which can be called fron the 
terminal or cther CSS files and executed in a predefined 
sequence. In this way, complex operations can be carried out by 
the terminal user with only a small number of commands. CSS 
provides: 


® the ability to switch the command input stream to a file or 
device; 


® a set of logical operators to control the precise sequenca of 
commands: 


© paraneters that can be passed to a CSS file so that general 
. sequcnces can be written to take on specific meaning when the 
parameters are substituted; and 


€ the ability for one CSS file to call another, in the manner of 
a Subroutine, so that complex command sequences can be 
developed. 


A CSS file is simply a sequential text file. It could be a deck 
Of -cerdac, a magnetic tare, or 2 dise file. An @eanrle oof A 
simpie CSS file is: 


*THIS IS A SIMPLE EXAMPLE OF A CSS FILE 
LOAD TEST.TSK/G,5 

ALLOCATE XXXDIX.DTA,CO,40 

AS 1,INPUT.DTA 

AS 2,-XXXDIX.«DTASAS 5, CON: 

ASSIGN 3,PRT2:;*LU3-LINEPRINTER 

START 

SEXIT 


5-2 CALLING A CSS FILE 


A CSS file is called and executed from the terminal by specifying 
the file descriptor (fd) of the CSS file. Any valid fd can be 


